cht-conf 4.4.0 → 4.5.0

package/src/lib/compilation/validate-declarative-schema.js

@@ -3,7 +3,9 @@ const joi = require('joi');
 const { error, warn } = require('../log');
 
 const err = (filename, message) => details => {
-  const acceptedValues = details[0].local.valids ? ` but only ${JSON.stringify(details[0].local.valids)} are allowed` : '';
+  const acceptedValues = details[0].local.valids
+    ? ` but only ${JSON.stringify(details[0].local.valids)} are allowed`
+    : '';
   return new Error(`Invalid schema at ${filename}${details[0].local.label}
 ${message}
 Current value of ${filename}${details[0].local.label} is ${JSON.stringify(details[0].value)}${acceptedValues}
@@ -45,8 +47,9 @@ const TargetSchema = joi.array().items(
         then: joi.function().required(),
         otherwise: joi.function().forbidden(),
       })
-    })
-      .error(targetError('"passesIf" is required only "type=percent" and "groupBy" is not defined. Otherwise, it is forbidden.')),
+    }).error(targetError(
+      '"passesIf" is required only "type=percent" and "groupBy" is not defined. Otherwise, it is forbidden.'
+    )),
     groupBy: joi.function().optional()
       .error(targetError('"groupBy" should be of type function(contact, report)')),
     passesIfGroupCount: joi.alternatives().conditional('groupBy', {
@@ -57,23 +60,25 @@ const TargetSchema = joi.array().items(
       otherwise: joi.forbidden(),
     }),
     date: joi.alternatives().try(
-        joi.string().valid('reported', 'now'),
-        joi.function(),
-      )
+      joi.string().valid('reported', 'now'),
+      joi.function(),
+    )
       .optional()
-      .error(targetError('"date" should be either ["reported", "now"] or "function(contact, report)" returning timestamp')),
+      .error(targetError(
+        '"date" should be either ["reported", "now"] or "function(contact, report)" returning timestamp'
+      )),
     emitCustom: joi.function().optional()
       .error(targetError('"emitCustom" should be a function')),
     dhis: joi.alternatives().try(
-        DhisSchema,
-        joi.array().items(DhisSchema),
-      )
-        .optional(),
+      DhisSchema,
+      joi.array().items(DhisSchema),
+    )
+      .optional(),
     visible: joi.boolean().optional(),
     idType: joi.alternatives().try(
-        joi.string().valid('report', 'contact'),
-        joi.function(),
-      )
+      joi.string().valid('report', 'contact'),
+      joi.function(),
+    )
       .optional()
       .error(targetError('idType should be either "report" or "contact" or "function(contact, report)"')),
     aggregate: joi.boolean().optional(),
@@ -83,14 +88,20 @@ const TargetSchema = joi.array().items(
   .required();
 
 const EventSchema = idPresence => joi.object({
-    id: joi.string().presence(idPresence),
-    days: joi.alternatives().conditional('dueDate', { is: joi.exist(), then: joi.forbidden(), otherwise: joi.number().required() })
-      .error(taskError('"event.days" is a required integer field only when "event.dueDate" is absent')),
-    dueDate: joi.alternatives().conditional('days', { is: joi.exist(), then: joi.forbidden(), otherwise: joi.function().required() })
-      .error(taskError('"event.dueDate" is required to be "function(event, contact, report)" only when "event.days" is absent')),
-    start: joi.number().min(0).required(),
-    end: joi.number().min(0).required(),
-  });
+  id: joi.string().presence(idPresence),
+  days: joi.alternatives().conditional(
+    'dueDate',
+    { is: joi.exist(), then: joi.forbidden(), otherwise: joi.number().required() }
+  ).error(taskError('"event.days" is a required integer field only when "event.dueDate" is absent')),
+  dueDate: joi.alternatives().conditional(
+    'days',
+    { is: joi.exist(), then: joi.forbidden(), otherwise: joi.function().required() }
+  ).error(taskError(
+    '"event.dueDate" is required to be "function(event, contact, report)" only when "event.days" is absent'
+  )),
+  start: joi.number().min(0).required(),
+  end: joi.number().min(0).required(),
+});
 
 const TaskSchema = joi.array().items(
   joi.object({
@@ -103,7 +114,7 @@ const TaskSchema = joi.array().items(
     appliesToType: joi.array().items(joi.string()).optional().min(1),
     contactLabel:
       joi.alternatives().try( joi.string().min(1), joi.function() ).optional()
-      .error(taskError('"contactLabel" should either be a non-empty string or function(contact, report)')),
+        .error(taskError('"contactLabel" should either be a non-empty string or function(contact, report)')),
     resolvedIf: joi
       .alternatives()
       .conditional('actions', {
@@ -111,12 +122,10 @@ const TaskSchema = joi.array().items(
         then: joi.function().optional(),
         otherwise: joi.function().required()
       })
-      .error(
-        taskError(
-          'ERROR: Schema error in actions array: Actions with property "type" which value is different than "report", ' +
-          'should define property "resolvedIf" as: function(contact, report) { ... }.'
-        )
-      ),
+      .error(taskError(
+        'ERROR: Schema error in actions array: Actions with property "type" which value is different than "report", ' +
+        'should define property "resolvedIf" as: function(contact, report) { ... }.'
+      )),
     events: joi.alternatives().conditional('events', {
       is: joi.array().length(1),
       then: joi.array().items(EventSchema('optional')).min(1).required(),
@@ -130,11 +139,18 @@ const TaskSchema = joi.array().items(
       joi.function(),
     )
       .optional()
-      .error(taskError('"priority" should be an object with optional fields "level" and "label" or a function which returns the same')),
+      .error(taskError(
+        '"priority" should be an object with optional fields "level" and "label" or a function which returns the same'
+      )),
     actions: joi.array().items(
       joi.object({
         type: joi.string().valid('report', 'contact').optional(),
-        form: joi.alternatives().conditional('type', { is: 'contact', then: joi.forbidden(), otherwise: joi.string().min(1).required() }),
+        form: joi
+          .alternatives()
+          .conditional(
+            'type',
+            { is: 'contact', then: joi.forbidden(), otherwise: joi.string().min(1).required() }
+          ),
         label: joi.string().min(1).optional(),
         modifyContent: joi.function().optional()
           .error(taskError('"actions.modifyContent" should be "function (content, contact, report)')),
@@ -181,7 +197,8 @@ const validate = (filename, fileContent, schema) => {
 const formatJoiError = (desc, detail) => {
   const { context } = detail;
   if (detail.type === 'array.unique') {
-    return `${desc}${context.label} contains duplicate value for the "${context.path}" field: "${context.value[context.path]}"`;
+    const fieldValue = context.value[context.path];
+    return `${desc}${context.label} contains duplicate value for the "${context.path}" field: "${fieldValue}"`;
   }
 
   let result = detail.message;

package/src/lib/convert-forms.js

@@ -31,7 +31,9 @@ const formFileMatcher = (fileName) => {
 };
 
 const execute = async (projectDir, subDirectory, options) => {
-  if (!options) options = {};
+  if (!options) {
+    options = {};
+  }
 
   const formsDir = getFormDir(projectDir, subDirectory);
 
@@ -43,7 +45,7 @@ const execute = async (projectDir, subDirectory, options) => {
   const filesToConvert = argsFormFilter(formsDir, FORM_EXTENSION, options)
     .filter(name => formFileMatcher(name));
 
-  for (let xls of filesToConvert) {
+  for (const xls of filesToConvert) {
     const originalSourcePath = `${formsDir}/${xls}`;
     let sourcePath;
 
@@ -51,7 +53,9 @@ const execute = async (projectDir, subDirectory, options) => {
       const temporaryPath = `${fs.mkdtemp()}/${options.force_data_node}.xlsx`;
       fs.copy(originalSourcePath, temporaryPath);
       sourcePath = temporaryPath;
-    } else sourcePath = originalSourcePath;
+    } else {
+      sourcePath = originalSourcePath;
+    }
 
     const targetPath = `${fs.withoutExtension(originalSourcePath)}.xml`;
 
@@ -76,8 +80,14 @@ const xls2xform = (sourcePath, targetPath) =>
       if (executableAvailable()) {
         if (e.includes('unrecognized arguments: --skip_validate')) {
           throw new Error('Your xls2xform installation appears to be out of date.' + UPDATE_INSTRUCTIONS);
-        } else throw e;
-      } else throw new Error('There was a problem executing xls2xform.  It may not be installed.' + INSTALLATION_INSTRUCTIONS);
+        } else {
+          throw e;
+        }
+      } else {
+        throw new Error(
+          'There was a problem executing xls2xform.  It may not be installed.' + INSTALLATION_INSTRUCTIONS
+        );
+      }
     });
 
 // here we fix the form content in arcane ways.  Seeing as we have out own fork
@@ -103,14 +113,18 @@ const fixXml = (path, hiddenFields, transformer, enketo) => {
 
   // Enketo _may_ not work with forms which define a default language - see
   // https://github.com/medic/cht-core/issues/3174
-  if (enketo) xml = xml.replace(/ default="true\(\)"/g, '');
+  if (enketo) {
+    xml = xml.replace(/ default="true\(\)"/g, '');
+  }
 
   if (hiddenFields) {
     const r = new RegExp(`<(${hiddenFields.join('|')})(/?)>`, 'g');
     xml = xml.replace(r, '<$1 tag="hidden"$2>');
   }
 
-  if (transformer) xml = transformer(xml, path);
+  if (transformer) {
+    xml = transformer(xml, path);
+  }
 
 
   // Check for deprecations
@@ -122,8 +136,12 @@ const fixXml = (path, hiddenFields, transformer, enketo) => {
 };
 
 function getHiddenFields(propsJson) {
-  if (!fs.exists(propsJson)) return [];
-  else return fs.readJson(propsJson).hidden_fields;
+  if (!fs.exists(propsJson)) {
+    return [];
+  }
+  else {
+    return fs.readJson(propsJson).hidden_fields;
+  }
 }
 
 function executableAvailable() {

package/src/lib/exec-promise.js

@@ -6,26 +6,34 @@ const log = require('../lib/log');
 
 module.exports = (args, logLevel=log.level) => new Promise((resolve, reject) => {
 
-    // Include stdout at log.LEVEL_WARN because xls2xform outputs warnings on stdout
+  // Include stdout at log.LEVEL_WARN because xls2xform outputs warnings on stdout
 
-    let stdio;
-    if (logLevel >= log.LEVEL_WARN) {
-      stdio = [ 'ignore',  'pipe',   'pipe' ];
-    } else if (logLevel >= log.LEVEL_ERROR) {
-      stdio = [ 'ignore', 'ignore',  'pipe' ];
-    } else {
-      stdio = [ 'ignore', 'ignore', 'ignore' ];
-    }
+  let stdio;
+  if (logLevel >= log.LEVEL_WARN) {
+    stdio = [ 'ignore',  'pipe',   'pipe' ];
+  } else if (logLevel >= log.LEVEL_ERROR) {
+    stdio = [ 'ignore', 'ignore',  'pipe' ];
+  } else {
+    stdio = [ 'ignore', 'ignore', 'ignore' ];
+  }
 
-    const sub = exec(
-      args.join(' '),
-      { stdio:stdio },
-      (err, stdout, stderr) => {
-        if(err) reject(stderr);
-        else resolve(stdout);
-      });
+  const sub = exec(
+    args.join(' '),
+    { stdio:stdio },
+    (err, stdout, stderr) => {
+      if(err) {
+        reject(stderr);
+      }
+      else {
+        resolve(stdout);
+      }
+    });
 
-    if(logLevel >= log.LEVEL_WARN)  sub.stdout.pipe(process.stdout);
-    if(logLevel >= log.LEVEL_ERROR) sub.stderr.pipe(process.stderr);
+  if(logLevel >= log.LEVEL_WARN)  {
+    sub.stdout.pipe(process.stdout);
+  }
+  if(logLevel >= log.LEVEL_ERROR) {
+    sub.stderr.pipe(process.stderr);
+  }
 
-  });
+});

package/src/lib/fetch-document-list.js

@@ -9,8 +9,8 @@ const findErrors = (rows) => {
 
   rows.forEach(row => {
     if (!row.doc) {
-        errors.docNotFound.push(`Document with id '${row.key}' could not be found.`);
-        return;
+      errors.docNotFound.push(`Document with id '${row.key}' could not be found.`);
+      return;
     }
 
     if (!VALID_DOC_TYPES.includes(row.doc.type)) {

package/src/lib/generate-users-csv.js

@@ -3,7 +3,7 @@ const fs = require('./sync-fs');
 const info = require('./log').info;
 
 module.exports = (data, csvPath) => {
-  const fields = ['username', 'password', 'roles', 'contact', 'phone', 'place'];
+  const fields = ['username', 'password', 'roles', 'contact', 'phone', 'place', 'fullname', 'email'];
   const json2csvParser = new Json2csvParser({
     fields,
     doubleQuote: '\'',

package/src/lib/get-api-url.js

@@ -25,7 +25,10 @@ const getApiUrl = (cmdArgs, env = {}) => {
     // See ./archiving-db.js
     instanceUrl = parseLocalUrl(env.COUCH_URL);
     if (instanceUrl.hostname !== 'localhost') {
-      throw Error(`--local was specified but COUCH_URL env var is set to '${instanceUrl.hostname}'.  Please use --url for remote servers.`);
+      throw Error(
+        `--local was specified but COUCH_URL env var is set to '${instanceUrl.hostname}'.  `
+        + `Please use --url for remote servers.`
+      );
     }
   } else if (cmdArgs.instance) {
     const password = userPrompt.question(`${emoji.key}  Password: `, { hideEchoBack: true });

package/src/lib/google-auth.js

@@ -11,11 +11,15 @@ const TOKENS_FILE = './.gdrive.session.json';
 module.exports = () => {
   const client = oauthClient();
 
-  if(!fs.exists(TOKENS_FILE)) return newSessionFor(client);
+  if(!fs.exists(TOKENS_FILE)) {
+    return newSessionFor(client);
+  }
 
   client.setCredentials(fs.readJson(TOKENS_FILE));
 
-  if(client.credentials.expiry_date < Date.now()) return newSessionFor(client);
+  if(client.credentials.expiry_date < Date.now()) {
+    return newSessionFor(client);
+  }
 
   return Promise.resolve(client);
 };
@@ -30,7 +34,9 @@ function newSessionFor(client) {
 
   return new Promise((resolve, reject) => {
     client.getToken(accessCode, function (err, tokens) {
-      if(err) return reject(err);
+      if(err) {
+        return reject(err);
+      }
 
       fs.writeJson(TOKENS_FILE, tokens);
 
@@ -61,7 +67,9 @@ function oauthClient() {
       checkRequired(clientSecret, 'client_secret', 'GOOGLE_CLIENT_SECRET') |
       checkRequired(redirectUri, 'redirect_uris', 'GOOGLE_REDIRECT_URI');
 
-  if(missingConfig) throw new Error('Missing required config for google drive access.  Please check warnings.');
+  if(missingConfig) {
+    throw new Error('Missing required config for google drive access.  Please check warnings.');
+  }
 
   return new google.auth.OAuth2(clientId, clientSecret, redirectUri);
 }
@@ -72,7 +80,9 @@ function openBrowserAt(url) {
 }
 
 function checkRequired(value, jsonKey, envVar) {
-  if(value) return;
+  if(value) {
+    return;
+  }
 
   warn(`Missing .${jsonKey} in ${SECRETS_FILE} or env var ${envVar}!`);
   return true;

package/src/lib/hierarchy-operations/delete-hierarchy.js

@@ -23,7 +23,10 @@ async function deleteHierarchy(db, options, sourceIds) {
 
     const affectedContactCount = descendantsAndSelf.length;
     
-    info(`Staged updates to delete ${prettyPrintDocument(sourceDoc)}. ${affectedContactCount.length} contact(s) and ${affectedReportCount} report(s).`);
+    info(
+      `Staged updates to delete ${prettyPrintDocument(sourceDoc)}. ${affectedContactCount.length} contact(s) `
+      + `and ${affectedReportCount} report(s).`
+    );
   }
 }
 

package/src/lib/hierarchy-operations/hierarchy-data-source.js

@@ -12,7 +12,9 @@ async function getContactsByIds(db, ids) {
     include_docs: true,
   });
 
-  const missingContactErrors = contactDocs.rows.filter(row => !row.doc).map(row => `Contact with id '${row.key}' could not be found.`);
+  const missingContactErrors = contactDocs.rows
+    .filter(row => !row.doc)
+    .map(row => `Contact with id '${row.key}' could not be found.`);
   if (missingContactErrors.length > 0) {
     throw Error(missingContactErrors);
   }
@@ -86,7 +88,10 @@ async function getAncestorsOf(db, contactDoc) {
 
   const ancestorIdsNotFound = ancestors.rows.filter(ancestor => !ancestor.doc).map(ancestor => ancestor.key);
   if (ancestorIdsNotFound.length > 0) {
-    throw Error(`Contact '${contactDoc?.name}' (${contactDoc?._id}) has parent id(s) '${ancestorIdsNotFound.join(',')}' which could not be found.`);
+    throw Error(
+      `Contact '${contactDoc?.name}' (${contactDoc?._id}) has parent id(s) `
+      + `'${ancestorIdsNotFound.join(',')}' which could not be found.`
+    );
   }
 
   return ancestors.rows.map(ancestor => ancestor.doc);

package/src/lib/hierarchy-operations/index.js

@@ -35,11 +35,17 @@ async function moveHierarchy(db, options, sourceIds, destinationId) {
     }
         
     const prettyPrintDocument = doc => `'${doc.name}' (${doc._id})`;
-    trace(`Considering lineage updates to ${descendantsAndSelf.length} descendant(s) of contact ${prettyPrintDocument(sourceDoc)}.`);
+    trace(
+      `Considering lineage updates to ${descendantsAndSelf.length} descendant(s) of contact `
+      + `${prettyPrintDocument(sourceDoc)}.`
+    );
     const updatedDescendants = replaceLineageInContacts(moveContext);
     
     const ancestors = await DataSource.getAncestorsOf(db, sourceDoc);
-    trace(`Considering primary contact updates to ${ancestors.length} ancestor(s) of contact ${prettyPrintDocument(sourceDoc)}.`);
+    trace(
+      `Considering primary contact updates to ${ancestors.length} ancestor(s) of contact `
+      + `${prettyPrintDocument(sourceDoc)}.`
+    );
     const updatedAncestors = replaceLineageInAncestors(descendantsAndSelf, ancestors);
     
     minifyLineageAndWriteToDisk(options, [...updatedDescendants, ...updatedAncestors]);
@@ -50,10 +56,16 @@ async function moveHierarchy(db, options, sourceIds, destinationId) {
     affectedContactCount += updatedDescendants.length + updatedAncestors.length;
     affectedReportCount += movedReportsCount;
 
-    info(`Staged updates to ${prettyPrintDocument(sourceDoc)}. ${updatedDescendants.length} contact(s) and ${movedReportsCount} report(s).`);
+    info(
+      `Staged updates to ${prettyPrintDocument(sourceDoc)}. ${updatedDescendants.length} contact(s) and `
+      + `${movedReportsCount} report(s).`
+    );
   }
 
-  info(`Staged changes to lineage information for ${affectedContactCount} contact(s) and ${affectedReportCount} report(s).`);
+  info(
+    `Staged changes to lineage information for ${affectedContactCount} contact(s) and `
+    + `${affectedReportCount} report(s).`
+  );
 }
 
 async function updateReports(db, options, moveContext) {

package/src/lib/hierarchy-operations/jsdocFolder.js

@@ -22,7 +22,10 @@ function writeDoc({ docDirectoryPath }, doc) {
 }
 
 function deleteAfterConfirmation(docDirectoryPath) {
-  warn(`The document folder '${docDirectoryPath}' already contains files. It is recommended you start with a clean folder. Do you want to delete the contents of this folder and continue?`);
+  warn(
+    `The document folder '${docDirectoryPath}' already contains files. `
+    + 'It is recommended you start with a clean folder. Do you want to delete the contents of this folder and continue?'
+  );
   if (!userPrompt.keyInYN()) {
     throw new Error('User aborted execution.');
   }

package/src/lib/hierarchy-operations/lineage-constraints.js

@@ -11,7 +11,10 @@ module.exports = async (db, options) => {
     assertNoPrimaryContactViolations: async (sourceDoc, destinationDoc, descendantDocs) => {
       const invalidPrimaryContactDoc = await getPrimaryContactViolations(db, sourceDoc, destinationDoc, descendantDocs);
       if (invalidPrimaryContactDoc) {
-        throw Error(`Cannot remove contact '${invalidPrimaryContactDoc?.name}' (${invalidPrimaryContactDoc?._id}) from the hierarchy for which they are a primary contact.`);
+        throw Error(
+          `Cannot remove contact '${invalidPrimaryContactDoc?.name}' (${invalidPrimaryContactDoc?._id}) from the `
+          + 'hierarchy for which they are a primary contact.'
+        );
       }
     },
     assertNoHierarchyErrors: (sourceDocs, destinationDoc) => {
@@ -29,9 +32,10 @@ module.exports = async (db, options) => {
       });
   
       /*
-      It is nice that the tool can move lists of contacts as one operation, but strange things happen when two contactIds are in the same lineage.
-      For example, moving a district_hospital and moving a contact under that district_hospital to a new clinic causes multiple colliding writes to the same json file.
-      */
+       * It is nice that the tool can move lists of contacts as one operation, but strange things happen when two
+       * contactIds are in the same lineage. For example, moving a district_hospital and moving a contact under that
+       * district_hospital to a new clinic causes multiple colliding writes to the same json file.
+       */
       const contactIds = sourceDocs.map(doc => doc._id);
       sourceDocs
         .forEach(doc => {
@@ -81,7 +85,8 @@ function findCircularHierarchyErrors(sourceDoc, destinationDoc) {
 
   const parentAncestry = lineageManipulation.pluckIdsFromLineage(destinationDoc);
   if (parentAncestry.includes(sourceDoc._id)) {
-    return `Circular hierarchy: Cannot set parent of contact '${sourceDoc._id}' as it would create a circular hierarchy.`;
+    return `Circular hierarchy: Cannot set parent of contact '${sourceDoc._id}' `
+      + `as it would create a circular hierarchy.`;
   }
 }
 
@@ -117,7 +122,8 @@ const getMergeViolations = (sourceDoc, destinationDoc) => {
   const sourceContactType = getContactType(sourceDoc);
   const destinationContactType = getContactType(destinationDoc);
   if (sourceContactType !== destinationContactType) {
-    return `source and destinations must have the same type. Source is "${sourceContactType}" while destination is "${destinationContactType}".`;
+    return `source and destinations must have the same type. `
+      + `Source is "${sourceContactType}" while destination is "${destinationContactType}".`;
   }
 };
 

package/src/lib/hierarchy-operations/replace-lineage.js

@@ -48,28 +48,30 @@ function replaceEntireLineage(replaceInDoc, lineageAttributeName, replaceWith) {
 }
 
 module.exports = {
-/**
- * Given a doc, replace the parent's lineage
- * 
- * @param {Object} doc A CouchDB document containing a parent lineage (eg. parent.parent._id) 
- * @param {Object} params 
- * @param {Object} params.replaceWith The new hierarchy { parent: { _id: 'parent', parent: { _id: 'grandparent' } }
- * @param {string} params.startingFromId Only the part of the lineage "after" this id will be replaced
- * @param {boolean} params.merge When true, startingFromId is replaced and when false, startingFromId's parent is replaced 
- */
+  /**
+   * Given a doc, replace the parent's lineage
+   *
+   * @param {Object} doc A CouchDB document containing a parent lineage (eg. parent.parent._id)
+   * @param {Object} params
+   * @param {Object} params.replaceWith The new hierarchy { parent: { _id: 'parent', parent: { _id: 'grandparent' } }
+   * @param {string} params.startingFromId Only the part of the lineage "after" this id will be replaced
+   * @param {boolean} params.merge When true, startingFromId is replaced and when false, startingFromId's parent is
+   * replaced
+   */
   replaceParentLineage: (doc, params) => {
     return replaceLineage(doc, 'parent', params);
   },
 
-/**
- * Given a doc, replace the contact's lineage
- * 
- * @param {Object} doc A CouchDB document containing a contact lineage (eg. contact.parent._id)
- * @param {Object} params 
- * @param {Object} params.replaceWith The new hierarchy { parent: { _id: 'parent', parent: { _id: 'grandparent' } }
- * @param {string} params.startingFromId Only the part of the lineage "after" this id will be replaced
- * @param {boolean} params.merge When true, startingFromId is replaced and when false, startingFromId's parent is replaced 
- */
+  /**
+   * Given a doc, replace the contact's lineage
+   *
+   * @param {Object} doc A CouchDB document containing a contact lineage (eg. contact.parent._id)
+   * @param {Object} params
+   * @param {Object} params.replaceWith The new hierarchy { parent: { _id: 'parent', parent: { _id: 'grandparent' } }
+   * @param {string} params.startingFromId Only the part of the lineage "after" this id will be replaced
+   * @param {boolean} params.merge When true, startingFromId is replaced and when false, startingFromId's parent is
+   * replaced
+   */
   replaceContactLineage: (doc, params) => {
     return replaceLineage(doc, 'contact', params);
   },

package/src/lib/insert-or-replace.js

@@ -2,7 +2,11 @@ module.exports = (db, doc) =>
   db.get(doc._id)
     .then(existingDoc => doc._rev = existingDoc._rev)
     .catch(e => {
-      if(e.status === 404) return;
-      else throw e;
+      if(e.status === 404) {
+        return;
+      }
+      else {
+        throw e;
+      }
     })
     .then(() => db.put(doc));

package/src/lib/log.js

@@ -30,7 +30,11 @@ function logAtLevel(color, level, ...args) {
 }
 
 const redactUrls = s => {
-  if(s instanceof Error) s = s.stack || s.message || s;
-  if(s && typeof s !== 'string') s = JSON.stringify(s, null, 2);
+  if(s instanceof Error) {
+    s = s.stack || s.message || s;
+  }
+  if(s && typeof s !== 'string') {
+    s = JSON.stringify(s, null, 2);
+  }
   return s && redactBasicAuth(s);
 };

package/src/lib/main.js

@@ -168,11 +168,12 @@ module.exports = async (argv, env) => {
     await api().available();
   }
 
-  const productionUrlMatch = environment.instanceUrl && environment.instanceUrl.match(/^https:\/\/(?:[^@]*@)?(.*)\.(app|dev)\.medicmobile\.org(?:$|\/)/);
+  const productionUrlMatch = environment.instanceUrl
+    && environment.instanceUrl.match(/^https:\/\/(?:[^@]*@)?(.*)\.(app|dev)\.medicmobile\.org(?:$|\/)/);
   const expectedOptions = ['alpha', projectName];
   if (productionUrlMatch && !expectedOptions.includes(productionUrlMatch[1])) {
     warn(`Attempting to use project for \x1b[31m${projectName}\x1b[33m`,
-        `against non-matching instance: \x1b[31m${redactBasicAuth(environment.instanceUrl)}\x1b[33m`);
+      `against non-matching instance: \x1b[31m${redactBasicAuth(environment.instanceUrl)}\x1b[33m`);
     if (!userPrompt.keyInYN()) {
       throw new Error('User aborted execution.');
     }
@@ -189,7 +190,7 @@ module.exports = async (argv, env) => {
     await checkForUpdates({ nonFatal: true });
   }
 
-  for (let action of actions) {
+  for (const action of actions) {
     info(`Starting action: ${action.name}…`);
     await executeAction(action);
     info(`${action.name} complete.`);

package/src/lib/nools-utils.js

@@ -2,18 +2,20 @@ const minify = js =>
   js.split('\n')
     .map(s =>
       s.trim()
-       .replace(/\s*\/\/.*/, '') // single-line comments (like this one)
+        .replace(/\s*\/\/.*/, '') // single-line comments (like this one)
     ).join('')
-        .replace(/\s*\/\*(?:(?!\*\/).)*\*\/\s*/g, '') /* this kind of comment */
-        .replace(/function \(/g, 'function(') // different node versions do function.toString() differently :\
+    .replace(/\s*\/\*(?:(?!\*\/).)*\*\/\s*/g, '') /* this kind of comment */
+    .replace(/function \(/g, 'function(') // different node versions do function.toString() differently :\
         ;
 
+/* eslint-disable max-len */
 const addBoilerplateToCode = code => `define Target { _id: null, contact: null, deleted: null, type: null, pass: null, date: null, groupBy: null }
 define Contact { contact: null, reports: null, tasks: null }
 define Task { _id: null, deleted: null, doc: null, contact: null, icon: null, date: null, readyStart: null, readyEnd: null, title: null, fields: null, resolved: null, priority: null, priorityLabel: null, reports: null, actions: null }
 rule GenerateEvents {
   when { c: Contact } then { ${code} }
 }`;
+/* eslint-enable max-len */
 
 module.exports = {
   addBoilerplateToCode,

package/src/lib/parse-purge.js

@@ -14,7 +14,10 @@ module.exports = (projectDir) => {
   const purgingExists = fs.exists(purgingPath);
 
   if (purgeExists && purgingExists) {
-    throwError(`Purge is defined at both ${purgePath} and ${purgingPath}. Using 'purging.js' is deprecated. Create a 'purge.js' file instead.`);
+    throwError(
+      `Purge is defined at both ${purgePath} and ${purgingPath}. `
+      + `Using 'purging.js' is deprecated. Create a 'purge.js' file instead.`
+    );
   }
 
   let purgeConfig;