cityssm/node-docushare

import { JavaCaller } from "java-caller";

import * as defaults from "./defaults.js";
import * as utils from "./utils.js";

import type * as types from "./types";


/*
 * Setup
 */

// Java

let javaConfig: types.JavaConfig = defaults.JAVA_CONFIG;

export const setupJava = (config: types.JavaConfig): void => {
  javaConfig = Object.assign({}, defaults.JAVA_CONFIG, config);
};

// Server

let serverConfig: types.ServerConfig;

export const setupServer = (config: types.ServerConfig): void => {
  serverConfig = Object.assign({}, defaults.SERVER_CONFIG, config);
};

// Session

let sessionConfig: types.SessionConfig;

export const setupSession = (config: types.SessionConfig): void => {
  sessionConfig = Object.assign({}, defaults.SESSION_CONFIG, config);
};


/*
 * Java Helpers
 */


const buildJavaCallerOptions = (mainClass: string) => {

  return {
    rootPath: defaults.JAVA_ROOTPATH,
    classPath: [...defaults.JAVA_CLASSPATH, ...javaConfig.dsapiPath],
    useAbsoluteClassPaths: true,
    mainClass,
    minimumJavaVersion: defaults.JAVA_MINIMUMJAVAVERSION
  };
};

const buildJavaArguments = (methodArguments: string[]): string[] => {

  const javaArguments = [serverConfig.serverName,
  serverConfig.serverPort.toString(),
  sessionConfig.userDomain,
  sessionConfig.userName,
  sessionConfig.password];

  for (const methodArgument of methodArguments) {

    if (methodArgument.includes(" ")) {
      javaArguments.push("\"" + methodArgument + "\"");
    } else {
      javaArguments.push(methodArgument);
    }
  }

  return javaArguments;
};

const runJavaApplication = async (applicationClassName: string, applicationArguments: string[]): Promise<types.DocuShareOutput> => {

  const java = new JavaCaller(
    buildJavaCallerOptions("cityssm.nodedocusharejava." + applicationClassName)
  );

  const javaOutput: types.JavaOutput = await java.run(
    buildJavaArguments(applicationArguments)
  );

  const docuShareOutput = utils.parseOutput(javaOutput);

  return docuShareOutput;
};


/*
 * Read
 */


/**
 * Finds a single DocuShare object by a handle (i.e. "Collection-123")
 */
export const findByHandle = async (handleString: string): Promise<types.DocuShareOutput> => {

  return await runJavaApplication(
    "FindByHandle",
    [handleString]
  );
};

export const findByObjectClassAndID = async (objectClass: types.DocuShareObjectClass, objectID: number): Promise<types.DocuShareOutput> => {
  return await findByHandle(objectClass + "-" + objectID.toString());
};

/**
 * Retrieves the child objects of a given DocuShare Collection.
 */
export const getChildren = async (parentCollectionHandleString: string): Promise<types.DocuShareOutput> => {

  return await runJavaApplication(
    "GetChildren",
    [parentCollectionHandleString]
  );
};

/**
 * Retrieves the child objects of a given DocuShare Collection
 * filtering them by given criteria.
 */
export const findChildren = async (parentCollectionHandleString: string, findChildrenFilters: types.FindChildrenFilters = {}): Promise<types.DocuShareOutput> => {

  const children = await getChildren(parentCollectionHandleString);

  if (!children.success) {
    return children;
  }

  // Prepare filters

  for (const filterKey of Object.keys(findChildrenFilters)) {
    findChildrenFilters[filterKey].searchString = findChildrenFilters[filterKey].searchString.trim().toLowerCase();
    findChildrenFilters[filterKey]._searchStringSplit = findChildrenFilters[filterKey].searchString.split(" ");
  }

  children.dsObjects = children.dsObjects.filter((dsObject) => {

    for (const filterKey of Object.keys(findChildrenFilters)) {

      const filter: types.Filter = findChildrenFilters[filterKey];

      const searchText = filterKey === "text"
        ? (dsObject.title + " " + dsObject.summary + " " + dsObject.description).toLowerCase()
        : dsObject[filterKey].toLowerCase();

      if (filter.searchType === "equals" && searchText !== filter.searchString) {
        return false;

      } else if (filter.searchType === "includes" && !searchText.includes(filter.searchString)) {
        return false;

      } else if (filter.searchType === "includesPieces") {

        for (const searchStringPiece of filter._searchStringSplit) {
          if (!searchText.includes(searchStringPiece)) {
            return false;
          }
        }
      }
    }

    return true;
  });

  return children;
};


/*
 * Create
 */


/**
 * Creates a new Collection beneath a given DocuShare Collection.
 */
export const createCollection = async (parentCollectionHandleString: string, collectionTitle: string): Promise<types.DocuShareOutput> => {

  return await runJavaApplication(
    "CreateCollection",
    [parentCollectionHandleString, collectionTitle]
  );
};


/*
 * Update
 */


/**
 * Updates a given DocuShare object with a new title.
 */
export const setTitle = async (handleString: string, title: string): Promise<types.DocuShareOutput> => {

  return await runJavaApplication(
    "SetTitle",
    [handleString, title]
  );
};


/**
 * Updates a given DocuShare object with new keywords.
 */
 export const setKeywords = async (handleString: string, keywords: string): Promise<types.DocuShareOutput> => {

  return await runJavaApplication(
    "SetKeywords",
    [handleString, keywords]
  );
};


/*
 * Delete
 */


/**
 * Removes a given DocuShare object.
 */
export const deleteObject = async (handleString: string): Promise<types.DocuShareOutput> => {

  return await runJavaApplication(
    "DeleteObject",
    [handleString]
  );
};