motion-master-client 0.0.21 → 0.0.22

package/src/lib/{types.d.ts → types.ts}

@@ -1,26 +1,43 @@
 import { motionmaster } from "./motion-master.proto";
+
 export import MotionMasterMessage = motionmaster.MotionMasterMessage;
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
 export import IMotionMasterMessage = motionmaster.IMotionMasterMessage;
+
 export type StatusKey = keyof MotionMasterMessage.IStatus;
-export type RequestStatus = 'succeeded' | 'failed' | 'running';
-export declare class RequestError extends Error {
-}
-export type ParameterAddress = [number, number];
+
+export type RequestStatus =
+  | 'succeeded'
+  | 'failed'
+  | 'running';
+
+export class RequestError extends Error { }
+
+export type ParameterAddress = [number, number]; // index, subindex
 export type ParameterTypeValue = Omit<MotionMasterMessage.Request.SetDeviceParameterValues.IParameterValue, 'index' | 'subindex'>;
 export type ParameterTypeValueKey = keyof ParameterTypeValue;
 export type ParameterValueType = string | number | Uint8Array;
-export type ParameterAddressValue = [number, number, ParameterValueType, ParameterTypeValueKey?];
-export type DeviceParameterAddressValue = [DeviceRef, number, number, ParameterValueType, ParameterTypeValueKey?];
+export type ParameterAddressValue = [number, number, ParameterValueType, ParameterTypeValueKey?]; // index, subindex, value, typeValue
+export type DeviceParameterAddressValue = [DeviceRef, number, number, ParameterValueType, ParameterTypeValueKey?]; // index, subindex, value, typeValue
 export type DeviceParameterIds = string[] | [DeviceRef, number, number][];
+
 export type DeviceRefObj = {
-    deviceAddress?: (number | null);
-    deviceSerialNumber?: (string | null);
-    devicePosition?: (number | null);
+  deviceAddress?: (number | null); // already defined in the proto request messages
+  deviceSerialNumber?: (string | null);
+  devicePosition?: (number | null);
 };
+
 export type DeviceRef = number | string;
-export type ParameterInfoAndValue = MotionMasterMessage.Status.DeviceParameterInfo.IParameter & MotionMasterMessage.Status.DeviceParameterValues.IParameterValue;
+
+export type ParameterInfoAndValue = MotionMasterMessage.Status.DeviceParameterInfo.IParameter
+  & MotionMasterMessage.Status.DeviceParameterValues.IParameterValue;
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
 export import EthercatNetworkState = MotionMasterMessage.Request.SetEthercatNetworkState.State;
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
 export import ControllerType = MotionMasterMessage.Request.EnableMotionController.ControllerType;
+
 export type GetDeviceParameterInfoRequest = MotionMasterMessage.Request.IGetDeviceParameterInfo & DeviceRefObj;
 export type GetDeviceParameterValuesRequest = MotionMasterMessage.Request.IGetDeviceParameterValues & DeviceRefObj;
 export type GetMultiDeviceParameterValuesRequest = MotionMasterMessage.Request.IGetMultiDeviceParameterValues;
@@ -64,139 +81,53 @@ export type StopFullAutoTuningRequest = MotionMasterMessage.Request.IStopFullAut
 export type StartCirculoEncoderConfigurationRequest = MotionMasterMessage.Request.IStartCirculoEncoderConfiguration & DeviceRefObj;
 export type StopCirculoEncoderNarrowAngleCalibrationProcedureRequest = MotionMasterMessage.Request.IStopCirculoEncoderNarrowAngleCalibrationProcedure & DeviceRefObj;
 export type StartOsCommandRequest = MotionMasterMessage.Request.IStartOsCommand & DeviceRefObj;
-export type SystemVersionStatus = MotionMasterMessage.Status.ISystemVersion & {
-    request: RequestStatus;
-    messageId?: string;
-};
-export type DeviceInfoStatus = MotionMasterMessage.Status.IDeviceInfo & {
-    request: RequestStatus;
-    messageId?: string;
-};
-export type DeviceParameterInfoStatus = MotionMasterMessage.Status.IDeviceParameterInfo & {
-    request: RequestStatus;
-    messageId?: string;
-};
-export type DeviceParameterValuesStatus = MotionMasterMessage.Status.IDeviceParameterValues & {
-    request: RequestStatus;
-    messageId?: string;
-};
-export type MultiDeviceParameterValuesStatus = MotionMasterMessage.Status.IMultiDeviceParameterValues & {
-    request: RequestStatus;
-    messageId?: string;
-};
-export type DeviceFileListStatus = MotionMasterMessage.Status.IDeviceFileList & {
-    request: RequestStatus;
-    messageId?: string;
-};
-export type DeviceFileStatus = MotionMasterMessage.Status.IDeviceFile & {
-    request: RequestStatus;
-    messageId?: string;
-};
-export type DeviceFaultResetStatus = MotionMasterMessage.Status.IDeviceFaultReset & {
-    request: RequestStatus;
-    messageId?: string;
-};
-export type DeviceStopStatus = MotionMasterMessage.Status.IDeviceStop & {
-    request: RequestStatus;
-    messageId?: string;
-};
-export type DeviceFirmwareInstallationStatus = MotionMasterMessage.Status.IDeviceFirmwareInstallation & {
-    request: RequestStatus;
-    messageId?: string;
-};
-export type DeviceLogStatus = MotionMasterMessage.Status.IDeviceLog & {
-    request: RequestStatus;
-    messageId?: string;
-};
-export type CoggingTorqueRecordingStatus = MotionMasterMessage.Status.ICoggingTorqueRecording & {
-    request: RequestStatus;
-    messageId?: string;
-};
-export type CoggingTorqueDataStatus = MotionMasterMessage.Status.ICoggingTorqueData & {
-    request: RequestStatus;
-    messageId?: string;
-};
-export type OffsetDetectionStatus = MotionMasterMessage.Status.IOffsetDetection & {
-    request: RequestStatus;
-    messageId?: string;
-};
-export type PlantIdentificationStatus = MotionMasterMessage.Status.IPlantIdentification & {
-    request: RequestStatus;
-    messageId?: string;
-};
-export type AutoTuningStatus = MotionMasterMessage.Status.IAutoTuning & {
-    request: RequestStatus;
-    messageId?: string;
-};
-export type MotionControllerStatus = MotionMasterMessage.Status.IMotionController & {
-    request: RequestStatus;
-    messageId?: string;
-};
-export type SignalGeneratorStatus = MotionMasterMessage.Status.ISignalGenerator & {
-    request: RequestStatus;
-    messageId?: string;
-};
-export type MonitoringParameterValuesStatus = MotionMasterMessage.Status.IMonitoringParameterValues & {
-    request: RequestStatus;
-    messageId?: string;
-};
-export type EthercatNetworkStateStatus = MotionMasterMessage.Status.IEthercatNetworkState & {
-    request: RequestStatus;
-    messageId?: string;
-};
-export type NarrowAngleCalibrationStatus = MotionMasterMessage.Status.INarrowAngleCalibration & {
-    request: RequestStatus;
-    messageId?: string;
-};
-export type SystemIdentificationStatus = MotionMasterMessage.Status.ISystemIdentification & {
-    request: RequestStatus;
-    messageId?: string;
-};
-export type CirculoEncoderMagnetDistanceStatus = MotionMasterMessage.Status.ICirculoEncoderMagnetDistance & {
-    request: RequestStatus;
-    messageId?: string;
-};
-export type CirculoEncoderNarrowAngleCalibrationProcedureStatus = MotionMasterMessage.Status.ICirculoEncoderNarrowAngleCalibrationProcedure & {
-    request: RequestStatus;
-    messageId?: string;
-};
-export type DeviceCiA402StateStatus = MotionMasterMessage.Status.IDeviceCiA402State & {
-    request: RequestStatus;
-    messageId?: string;
-};
-export type SystemLogStatus = MotionMasterMessage.Status.ISystemLog & {
-    request: RequestStatus;
-    messageId?: string;
-};
-export type DeviceSiiRestoreStatus = MotionMasterMessage.Status.IDeviceSiiRestore & {
-    request: RequestStatus;
-    messageId?: string;
-};
-export type OpenLoopFieldControlStatus = MotionMasterMessage.Status.IOpenLoopFieldControl & {
-    request: RequestStatus;
-    messageId?: string;
-};
-export type FullAutoTuningStatus = MotionMasterMessage.Status.IFullAutoTuning & {
-    request: RequestStatus;
-    messageId?: string;
-};
-export type CirculoEncoderConfigurationStatus = MotionMasterMessage.Status.ICirculoEncoderConfiguration & {
-    request: RequestStatus;
-    messageId?: string;
-};
-export type OsCommandStatus = MotionMasterMessage.Status.IOsCommand & {
-    request: RequestStatus;
-    messageId?: string;
-};
+
+export type SystemVersionStatus = MotionMasterMessage.Status.ISystemVersion & { request: RequestStatus, messageId?: string };
+export type DeviceInfoStatus = MotionMasterMessage.Status.IDeviceInfo & { request: RequestStatus, messageId?: string };
+export type DeviceParameterInfoStatus = MotionMasterMessage.Status.IDeviceParameterInfo & { request: RequestStatus, messageId?: string };
+export type DeviceParameterValuesStatus = MotionMasterMessage.Status.IDeviceParameterValues & { request: RequestStatus, messageId?: string };
+export type MultiDeviceParameterValuesStatus = MotionMasterMessage.Status.IMultiDeviceParameterValues & { request: RequestStatus, messageId?: string };
+export type DeviceFileListStatus = MotionMasterMessage.Status.IDeviceFileList & { request: RequestStatus, messageId?: string };
+export type DeviceFileStatus = MotionMasterMessage.Status.IDeviceFile & { request: RequestStatus, messageId?: string };
+export type DeviceFaultResetStatus = MotionMasterMessage.Status.IDeviceFaultReset & { request: RequestStatus, messageId?: string };
+export type DeviceStopStatus = MotionMasterMessage.Status.IDeviceStop & { request: RequestStatus, messageId?: string };
+export type DeviceFirmwareInstallationStatus = MotionMasterMessage.Status.IDeviceFirmwareInstallation & { request: RequestStatus, messageId?: string };
+export type DeviceLogStatus = MotionMasterMessage.Status.IDeviceLog & { request: RequestStatus, messageId?: string };
+export type CoggingTorqueRecordingStatus = MotionMasterMessage.Status.ICoggingTorqueRecording & { request: RequestStatus, messageId?: string };
+export type CoggingTorqueDataStatus = MotionMasterMessage.Status.ICoggingTorqueData & { request: RequestStatus, messageId?: string };
+export type OffsetDetectionStatus = MotionMasterMessage.Status.IOffsetDetection & { request: RequestStatus, messageId?: string };
+export type PlantIdentificationStatus = MotionMasterMessage.Status.IPlantIdentification & { request: RequestStatus, messageId?: string };
+export type AutoTuningStatus = MotionMasterMessage.Status.IAutoTuning & { request: RequestStatus, messageId?: string };
+export type MotionControllerStatus = MotionMasterMessage.Status.IMotionController & { request: RequestStatus, messageId?: string };
+export type SignalGeneratorStatus = MotionMasterMessage.Status.ISignalGenerator & { request: RequestStatus, messageId?: string };
+export type MonitoringParameterValuesStatus = MotionMasterMessage.Status.IMonitoringParameterValues & { request: RequestStatus, messageId?: string };
+export type EthercatNetworkStateStatus = MotionMasterMessage.Status.IEthercatNetworkState & { request: RequestStatus, messageId?: string };
+export type NarrowAngleCalibrationStatus = MotionMasterMessage.Status.INarrowAngleCalibration & { request: RequestStatus, messageId?: string };
+export type SystemIdentificationStatus = MotionMasterMessage.Status.ISystemIdentification & { request: RequestStatus, messageId?: string };
+export type CirculoEncoderMagnetDistanceStatus = MotionMasterMessage.Status.ICirculoEncoderMagnetDistance & { request: RequestStatus, messageId?: string };
+export type CirculoEncoderNarrowAngleCalibrationProcedureStatus = MotionMasterMessage.Status.ICirculoEncoderNarrowAngleCalibrationProcedure & { request: RequestStatus, messageId?: string };
+export type DeviceCiA402StateStatus = MotionMasterMessage.Status.IDeviceCiA402State & { request: RequestStatus, messageId?: string };
+export type SystemLogStatus = MotionMasterMessage.Status.ISystemLog & { request: RequestStatus, messageId?: string };
+export type DeviceSiiRestoreStatus = MotionMasterMessage.Status.IDeviceSiiRestore & { request: RequestStatus, messageId?: string };
+export type OpenLoopFieldControlStatus = MotionMasterMessage.Status.IOpenLoopFieldControl & { request: RequestStatus, messageId?: string };
+export type FullAutoTuningStatus = MotionMasterMessage.Status.IFullAutoTuning & { request: RequestStatus, messageId?: string };
+export type CirculoEncoderConfigurationStatus = MotionMasterMessage.Status.ICirculoEncoderConfiguration & { request: RequestStatus, messageId?: string };
+export type OsCommandStatus = MotionMasterMessage.Status.IOsCommand & { request: RequestStatus, messageId?: string };
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
 export import ValueType = MotionMasterMessage.Status.DeviceParameterInfo.Parameter.ValueType;
-export declare function isArrayOfDeviceSerialNumbers(ids: DeviceParameterIds): ids is string[];
-export declare function isObjectOfDeviceSerialNumberToValues(ids: {
-    [deviceParameterId: string]: ParameterValueType;
-} | DeviceParameterAddressValue[]): ids is {
-    [deviceParameterId: string]: ParameterValueType;
-};
-export declare enum RestoreDefaultParametersType {
-    RESTORE_ALL_DEFAULT_PARAMETERS = 1,
-    RESTORE_MANUFACTURER_DEFAULT_PARAMETERS = 4
+
+export function isArrayOfDeviceSerialNumbers(ids: DeviceParameterIds): ids is string[] {
+  return ids.length > 0 && typeof ids[0] === 'string';
+}
+
+export function isObjectOfDeviceSerialNumberToValues(ids: { [deviceParameterId: string]: ParameterValueType } | DeviceParameterAddressValue[]): ids is { [deviceParameterId: string]: ParameterValueType } {
+  return !Array.isArray(ids);
+}
+
+export enum RestoreDefaultParametersType {
+  RESTORE_ALL_DEFAULT_PARAMETERS = 1,
+  RESTORE_MANUFACTURER_DEFAULT_PARAMETERS = 4,
 }
+
 export type Optional<T, K extends keyof T> = Pick<Partial<T>, K> & Omit<T, K>;

package/src/lib/urls.ts

@@ -0,0 +1,6 @@
+export const firmwarePackageBaseUrl = 'https://synapticon.s3.amazonaws.com/somanet-software/releases/';
+export const listFirmwarePackagesUrl = 'https://pc27e3jixd.execute-api.us-east-1.amazonaws.com/default/listFirmwarePackages';
+
+export function getFirmwarePackageUrl(filename: string) {
+  return firmwarePackageBaseUrl + filename;
+}

package/src/lib/util.ts

@@ -0,0 +1,305 @@
+import { inRange } from "lodash";
+import { DeviceLogLine } from "./device-log-line";
+import { Parameter, ParameterIndexSubindex } from "./parameter";
+import { SystemLogLine } from "./system-log-line";
+import { DeviceRef, DeviceRefObj, IMotionMasterMessage, MotionMasterMessage, ParameterAddressValue, ParameterTypeValue, ParameterTypeValueKey, ParameterValueType, ValueType } from "./types";
+
+export function getParameterTypeValueDefault(key: ParameterTypeValueKey) {
+  if (key === 'floatValue' || key === 'intValue' || key === 'uintValue') {
+    return 0;
+  } else if (key === 'rawValue') {
+    return Uint8Array.from([]);
+  } else if (key === 'stringValue') {
+    return '';
+  } else {
+    return 0;
+  }
+}
+
+export function getParameterTypeValue(parameter: MotionMasterMessage.Status.DeviceParameterValues.IParameterValue): ParameterTypeValueKey | undefined {
+  return (MotionMasterMessage.Status.DeviceParameterValues.ParameterValue.create(parameter)).typeValue;
+}
+
+export function getParameterValue(parameter: MotionMasterMessage.Status.DeviceParameterValues.IParameterValue): ParameterValueType {
+  const key = getParameterTypeValue(parameter);
+  if (key && key in parameter) {
+    return parameter[key] ?? getParameterTypeValueDefault(key);
+  }
+  return 0;
+}
+
+export function makeDeviceRefObj(deviceRef: DeviceRef): DeviceRefObj {
+  if (typeof deviceRef === 'number') {
+    if (deviceRef <= 0xFFFF) {
+      return { devicePosition: deviceRef };
+    } else {
+      return { deviceAddress: deviceRef };
+    }
+  } else {
+    return { deviceSerialNumber: deviceRef };
+  }
+}
+
+// TODO: Write unit tests.
+export function parseSystemLogLine(line: string): SystemLogLine | undefined {
+  const re = /(\d{4}-\d{2}-\d{2}\s\d{2}:\d{2}:\d{2}\.\d{1,3})\s\((.+)\)\s\[(.+)\](.+:\d+)(.+?)\|(.*)/s;
+  const result = re.exec(line);
+  if (result) {
+    return {
+      line,
+      date: new Date(result[1]),
+      uptime: result[2].trim(),
+      id: result[3].trim(),
+      file: result[4].trim(),
+      level: result[5].trim(),
+      message: result[6],
+    };
+  }
+  return;
+}
+
+// TODO: Write unit tests.
+export function parseSystemLogContent(content: string): SystemLogLine[] {
+  const re = /(\d{4}-\d{2}-\d{2}\s\d{2}:\d{2}:\d{2}\.\d{1,3}.+?)(?=\d{4}-\d{2}-\d{2}\s\d{2}:\d{2}:\d{2}\.\d{1,3}|$)/gs;
+  return content.split(re)
+    .filter((l) => l !== '')
+    .map((v) => parseSystemLogLine(v))
+    .filter((l): l is SystemLogLine => l !== undefined);
+}
+
+export function parseDeviceLog(line: string): DeviceLogLine | undefined {
+  const re = /^(\d{2}:\d{2}:\d{2}\.\d+)\s(.*)\|(.*)$/gm;
+  const result = re.exec(line);
+  if (result) {
+    return {
+      time: result[1].trim(),
+      level: result[2].trim(),
+      message: result[3].trim(),
+    };
+  }
+  return;
+}
+
+export function parseDeviceLogContent(content: string): DeviceLogLine[] {
+  return content.split('\n')
+    .map((v) => parseDeviceLog(v))
+    .filter((l): l is DeviceLogLine => l !== undefined);
+}
+
+export function mapParameterTypeValueToObject(type: keyof ParameterTypeValue, value: number | string): ParameterTypeValue {
+  const p: ParameterTypeValue = {};
+  if (type === 'floatValue') {
+    p['floatValue'] = typeof value === 'number' ? value : parseFloat(value);
+  } else if (type === 'intValue') {
+    p['intValue'] = typeof value === 'number' ? value : parseInt(value, 10);
+  } else if (type === 'rawValue') {
+    if (typeof value === 'number') {
+      p['rawValue'] = Uint8Array.from([value]);
+    } else {
+      let bytes: number[] = [];
+      if (value.startsWith('0x')) {
+        bytes = value.slice(2).match(/.{1,2}/g)?.map((h) => parseInt(h, 16)) ?? [];
+      } else {
+        bytes = value.split(',').map((c) => c.trim()).map((c) => parseInt(c, 10));
+      }
+      p['rawValue'] = Uint8Array.from(bytes);
+    }
+  } else if (type === 'stringValue') {
+    p['stringValue'] = typeof value === 'string' ? value : value.toString();
+  } else if (type === 'uintValue') {
+    p['uintValue'] = typeof value === 'number' ? value : parseInt(value, 10);
+  }
+  return p;
+}
+
+// Using bytes fixes: ERROR TypeError: Cannot freeze array buffer views with elements in NgRx
+export function createPlainObjectFromMotionMasterMessage(motionMasterMessage: MotionMasterMessage) {
+  return MotionMasterMessage.toObject(motionMasterMessage, {
+    bytes: Array, // Valid values are `Array`
+    defaults: true, // Also sets default values on the resulting object
+    arrays: true, // Sets empty arrays for missing repeated fields even if `defaults=false`
+    objects: true, // Sets empty objects for missing map fields even if `defaults=false`
+    oneofs: true, // Includes virtual oneof properties set to the present field's name, if any
+    json: true, // Performs additional JSON compatibility conversions, i.e. NaN and Infinity to strings
+  });
+}
+
+export function convertMotionMasterMessageToLoggerContext(motionMasterMessage: IMotionMasterMessage, namespace = 'reqResMessage') {
+  let type;
+  let name;
+
+  if (motionMasterMessage.request) {
+    type = 'request';
+    name = Object.keys(motionMasterMessage.request).join();
+  } else if (motionMasterMessage.status) {
+    type = 'status';
+    name = Object.keys(motionMasterMessage.status).join();
+  }
+
+  return { namespace, motionMasterMessage, type, name };
+}
+
+export function decodeTextContent(content: Uint8Array): string {
+  const decoder = new TextDecoder();
+  const buffer = Uint8Array.from(content);
+  return decoder.decode(buffer);
+}
+
+export function isRxPdoIndex(index: number): boolean {
+  return inRange(index, 0x1600, 0x1800);
+}
+
+export function isTxPdoIndex(index: number): boolean {
+  return inRange(index, 0x1A00, 0x1C00);
+}
+
+export function filterRxPdoParameters<T extends ParameterIndexSubindex>(parameters: T[], excludeSubIndex000 = false): T[] {
+  return parameters.filter((p) => isRxPdoIndex(p.index) && (excludeSubIndex000 ? p.subindex > 0 : true)); // RxPDOs: Index area 0x1600 to 0x17FF
+}
+
+export function filterTxPdoParameters<T extends ParameterIndexSubindex>(parameters: T[], excludeSubIndex000 = false): T[] {
+  return parameters.filter((p) => isTxPdoIndex(p.index) && (excludeSubIndex000 ? p.subindex > 0 : true)); // TxPDOs: Index area 0x1A00 to 0x1BFF
+}
+
+export function fillPdoParametersWithMappingEntries(parameters: Parameter[], entriesPerPdo = 10): Parameter[] {
+  const output: Parameter[] = [];
+  let i = 0;
+  while (i < parameters.length) {
+    if (parameters[i].subindex === 0) {
+      let j = i;
+      while (parameters[j] && (parameters[j].index === parameters[i].index)) {
+        output.push(parameters[j]);
+        j++;
+      }
+      let d = j - i;
+      while (d <= entriesPerPdo) {
+        output.push({
+          index: parameters[i].index,
+          subindex: d,
+          name: parameters[i].name,
+          uintValue: 0,
+          value: 0,
+          valueType: ValueType.UNSIGNED32,
+          group: parameters[i].group,
+          typeValue: "uintValue",
+          readAccess: true,
+          writeAccess: true,
+        });
+        d++;
+      }
+      i = j;
+    } else {
+      i++;
+    }
+  }
+  return output;
+}
+
+export function mapParameterToPdoSubItemValue(parameter: Parameter): number {
+  const { index, subindex } = parameter;
+  if (parameter.valueType && parameter.valueType < ValueType.VISIBLE_STRING) {
+    const buffer = new ArrayBuffer(4);
+    const view = new DataView(buffer);
+    const bitSize = mapValueTypeToBitSize(parameter.valueType);
+    view.setUint16(0, index);
+    view.setUint8(2, subindex);
+    view.setUint8(3, bitSize);
+    return view.getUint32(0);
+  }
+  return 0;
+}
+
+export function mapValueTypeToBitSize(valueType: ValueType): number {
+  switch (valueType) {
+    case ValueType.UNSPECIFIED:
+      return 0;
+    case ValueType.BOOLEAN:
+      return 1;
+    case ValueType.INTEGER8:
+    case ValueType.UNSIGNED8:
+      return 8;
+    case ValueType.INTEGER16:
+    case ValueType.UNSIGNED16:
+      return 16;
+    case ValueType.INTEGER32:
+    case ValueType.UNSIGNED32:
+    case ValueType.REAL32:
+      return 32;
+  }
+  throw new Error(`Non-numeric value type "${valueType}" (data types with variable length) cannot be mapped to bit size. You will have to get this info from ESI.`);
+}
+
+export const valueTypeToParameterTypeValueKeyMap = new Map<ValueType, keyof Required<ParameterTypeValue>>([
+  [ValueType.BOOLEAN, 'uintValue'],
+  [ValueType.INTEGER8, 'intValue'],
+  [ValueType.INTEGER16, 'intValue'],
+  [ValueType.INTEGER32, 'intValue'],
+  [ValueType.UNSIGNED8, 'uintValue'],
+  [ValueType.UNSIGNED16, 'uintValue'],
+  [ValueType.UNSIGNED32, 'uintValue'],
+  [ValueType.REAL32, 'floatValue'],
+  [ValueType.VISIBLE_STRING, 'stringValue'],
+  [ValueType.OCTET_STRING, 'stringValue'],
+  [ValueType.UNICODE_STRING, 'stringValue'],
+]);
+
+export function isValidDeviceRefObj(obj: DeviceRefObj): boolean {
+  return Number.isFinite(Number(obj.deviceAddress))
+    || (typeof obj.devicePosition === 'number' && obj.devicePosition >= 0)
+    || typeof obj.deviceSerialNumber === 'string';
+}
+
+export function createPdoParameterValues(parameters: Array<{ index: number, subindex: number, typeValue?: ParameterTypeValueKey }>, values: Array<ParameterValueType>) {
+  const output = parameters.map((parameter, i, arr) => {
+    const { index, subindex, typeValue } = parameter;
+    let value = values[i];
+    if (subindex === 0) {
+      value = arr.reduce((n, p, j) => (p.index === index && p.subindex > 0 && values[j]) ? n + 1 : n, 0);
+    }
+    return [index, subindex, value, typeValue];
+  }) as ParameterAddressValue[];
+
+  for (let i = 0; i < output.length - 1; i++) {
+    const [, subindex1, value1] = output[i];
+    if (subindex1 > 0 && value1 === 0) {
+      let j = i + 1;
+      let [, subindex2, value2] = output[j];
+      while (subindex2 > subindex1 && output[j]) {
+        if (typeof value2 === 'number' && value2 > 0) {
+          output[i][2] = value2;
+          output[j][2] = 0;
+          break;
+        }
+        if (output[++j]) {
+          [, subindex2, value2] = output[j];
+        }
+      }
+    }
+  }
+
+  return output;
+}
+
+export function resolveAfter(ms: number, value?: unknown) {
+  return new Promise(function (resolve) {
+    setTimeout(resolve.bind(null, value), ms);
+  });
+}
+
+export function convertRgbToLedColor(value: number) {
+  const r = (value >> 16) & 0xFF;
+  const g = (value >> 8) & 0xFF;
+  const b = value & 0xFF;
+  const ledColorValue = (g << 16) | (r << 8) | b;
+  return ledColorValue;
+}
+
+export function createRandomColor(brightness: number) {
+  function randomChannel(brightness: number) {
+    const r = 255 - brightness;
+    const n = 0 | ((Math.random() * r) + brightness);
+    const s = n.toString(16);
+    return (s.length == 1) ? '0' + s : s;
+  }
+  return '#' + randomChannel(brightness) + randomChannel(brightness) + randomChannel(brightness);
+}

package/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "module": "commonjs",
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "noImplicitOverride": true,
+    "noPropertyAccessFromIndexSignature": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "allowJs": true
+  },
+  "files": [],
+  "include": [],
+  "references": [
+    {
+      "path": "./tsconfig.lib.json"
+    },
+    {
+      "path": "./tsconfig.spec.json"
+    }
+  ]
+}

package/tsconfig.lib.json

@@ -0,0 +1,10 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../dist/out-tsc",
+    "declaration": true,
+    "types": ["node"]
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["jest.config.ts", "src/**/*.spec.ts", "src/**/*.test.ts"]
+}

package/tsconfig.spec.json

@@ -0,0 +1,20 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../dist/out-tsc",
+    "module": "commonjs",
+    "types": ["jest", "node"]
+  },
+  "include": [
+    "**/*.test.ts",
+    "**/*.spec.ts",
+    "**/*.test.tsx",
+    "**/*.spec.tsx",
+    "**/*.test.js",
+    "**/*.spec.js",
+    "**/*.test.jsx",
+    "**/*.spec.jsx",
+    "**/*.d.ts",
+    "jest.config.ts"
+  ]
+}

package/typedoc.json

@@ -0,0 +1,10 @@
+{
+  "entryPoints": [
+    "./src/index.ts"
+  ],
+  "out": "../../docs/motion-master-client",
+  "tsconfig": "./tsconfig.json",
+  "exclude": [
+    "**/*+(.spec|.e2e).ts"
+  ]
+}

package/src/index.js

@@ -1,29 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./lib/cia402"), exports);
-tslib_1.__exportStar(require("./lib/config-file"), exports);
-tslib_1.__exportStar(require("./lib/device-log-line"), exports);
-tslib_1.__exportStar(require("./lib/device-parameter"), exports);
-tslib_1.__exportStar(require("./lib/device"), exports);
-tslib_1.__exportStar(require("./lib/hardware-description"), exports);
-tslib_1.__exportStar(require("./lib/monitoring-config"), exports);
-tslib_1.__exportStar(require("./lib/monitoring-entry"), exports);
-tslib_1.__exportStar(require("./lib/motion-master-client"), exports);
-tslib_1.__exportStar(require("./lib/motion-master-pub-sub-client"), exports);
-tslib_1.__exportStar(require("./lib/motion-master-pub-sub-socket"), exports);
-tslib_1.__exportStar(require("./lib/motion-master-pub-sub-web-socket"), exports);
-tslib_1.__exportStar(require("./lib/motion-master-pub-sub-worker-socket"), exports);
-tslib_1.__exportStar(require("./lib/motion-master-req-res-client"), exports);
-tslib_1.__exportStar(require("./lib/motion-master-req-res-socket"), exports);
-tslib_1.__exportStar(require("./lib/motion-master-req-res-web-socket"), exports);
-tslib_1.__exportStar(require("./lib/motion-master-req-res-worker-socket"), exports);
-tslib_1.__exportStar(require("./lib/operators"), exports);
-tslib_1.__exportStar(require("./lib/options"), exports);
-tslib_1.__exportStar(require("./lib/parameter"), exports);
-tslib_1.__exportStar(require("./lib/request-status-resolver"), exports);
-tslib_1.__exportStar(require("./lib/system-log-line"), exports);
-tslib_1.__exportStar(require("./lib/types"), exports);
-tslib_1.__exportStar(require("./lib/urls"), exports);
-tslib_1.__exportStar(require("./lib/util"), exports);
-//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/motion-master-client/src/index.ts"],"names":[],"mappings":";;;AAAA,uDAA6B;AAC7B,4DAAkC;AAClC,gEAAsC;AACtC,iEAAuC;AACvC,uDAA6B;AAC7B,qEAA2C;AAC3C,kEAAwC;AACxC,iEAAuC;AACvC,qEAA2C;AAC3C,6EAAmD;AACnD,6EAAmD;AACnD,iFAAuD;AACvD,oFAA0D;AAC1D,6EAAmD;AACnD,6EAAmD;AACnD,iFAAuD;AACvD,oFAA0D;AAC1D,0DAAgC;AAChC,wDAA8B;AAC9B,0DAAgC;AAChC,wEAA8C;AAC9C,gEAAsC;AACtC,sDAA4B;AAC5B,qDAA2B;AAC3B,qDAA2B"}