src/helpers.ts

import { userInfo, hostname } from 'os';
import * as murmurHash3 from 'murmurhash3js';
import { Context } from './context';

export type FallbackFunction = (name: string, context: Context) => boolean;

export function createFallbackFunction(
  name: string,
  context: Context,
  fallback?: FallbackFunction | boolean,
): Function {
  if (typeof fallback === 'function') {
    return () => fallback(name, context);
  }
  if (typeof fallback === 'boolean') {
    return () => fallback;
  }
  return () => false;
}

export function resolveContextValue(context: Context, field: string): string | undefined {
  const contextValue = context[field] ?? context.properties?.[field];
  return contextValue !== undefined && contextValue !== null ? String(contextValue) : undefined;
}

export function safeName(str: string = '') {
  return str.replace(/\//g, '_');
}

export function generateInstanceId(instanceId?: string): string {
  if (instanceId) {
    return instanceId;
  }
  let info;
  try {
    info = userInfo();
  } catch (e) {
    // unable to read info;
  }

  const prefix = info
    ? info.username
    : `generated-${Math.round(Math.random() * 1000000)}-${process.pid}`;
  return `${prefix}-${hostname()}`;
}

export function generateHashOfConfig(o: Object): string {
  const oAsString = JSON.stringify(o);
  return murmurHash3.x86.hash128(oAsString);
}

export function getAppliedJitter(jitter: number): number {
  const appliedJitter = Math.random() * jitter;
  return Math.random() < 0.5 ? -appliedJitter : appliedJitter;
}