algorithm: average/mean

Maths/AverageMean.ts

@@ -0,0 +1,21 @@
+/**
+ * @function AverageMean
+ * @description This script will find the mean value of a array of numbers.
+ * @param {number[]} numbers - Array of numeric values
+ * @return {number} - mean of input numbers
+ * @see [Mean](https://en.wikipedia.org/wiki/Mean)
+ * @example AverageMean([1, 2, 4, 5]) = 3
+ * @example AverageMean([10, 40, 100, 20]) = 42.5
+ */
+
+export const AverageMean = (numbers: number[]): number => {
+  if (!Array.isArray(numbers) || numbers.length < 1) {
+    throw new TypeError("Invalid Input");
+  }
+
+  // This loop sums all values in the 'numbers' array using an array reducer
+  const sum = numbers.reduce((sum, current) => sum + current, 0);
+
+  // Divide sum by the length of the 'numbers' array.
+  return sum / numbers.length;
+};

Maths/test/AverageMean.test.ts

@@ -0,0 +1,31 @@
+import { AverageMean } from "../AverageMean";
+
+describe("Tests for AverageMean", () => {
+  it("should be a function", () => {
+    expect(typeof AverageMean).toEqual("function");
+  });
+
+  it("should throw error for invalid input", () => {
+    expect(() => AverageMean([])).toThrow();
+  });
+
+  it("should return the mean of an array of consecutive numbers", () => {
+    const meanFunction = AverageMean([1, 2, 3, 4]);
+    expect(meanFunction).toBe(2.5);
+  });
+
+  it("should return the mean of an array of numbers", () => {
+    const meanFunction = AverageMean([10, 40, 100, 20]);
+    expect(meanFunction).toBe(42.5);
+  });
+
+  it("should return the mean of an array of decimal numbers", () => {
+    const meanFunction = AverageMean([1.3, 12.67, 99.14, 20]);
+    expect(meanFunction).toBe(33.2775);
+  });
+
+  it("should return the mean of an array of numbers, including negatives", () => {
+    const meanFunction = AverageMean([10, -40, 100, -20]);
+    expect(meanFunction).toBe(12.5);
+  });
+});