@coast/core-utils 0.0.3 → 0.0.6

package/dist/ArrayUtils.d.ts

@@ -0,0 +1,9 @@
+import { NonEmptyArray } from './NonEmptyArray';
+type FirstElement<ARR> = ARR extends NonEmptyArray<infer U> ? U : ARR extends Array<infer U> ? U | null | undefined : never;
+export declare class ArrayUtils {
+    static liftNonEmpty<T>(data: T[]): NonEmptyArray<T>;
+    static first<T, Y extends T[]>(data: Y | null | undefined): FirstElement<Y>;
+    static isNonEmptyArray<T>(data: T[] | null | undefined): data is NonEmptyArray<T>;
+    static isUniformArray<E>(value: unknown, itemGuard?: (item: unknown) => item is E): value is E[];
+}
+export {};

package/dist/ArrayUtils.js

@@ -0,0 +1,43 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArrayUtils = void 0;
+const CoastException_1 = require("@coast/core-types/exception/CoastException");
+const lodash_1 = __importDefault(require("lodash"));
+class ArrayUtils {
+    static liftNonEmpty(data) {
+        if (ArrayUtils.isNonEmptyArray(data)) {
+            return data;
+        }
+        throw new CoastException_1.CoastException('Cannot lift empty array');
+    }
+    static first(data) {
+        if (ArrayUtils.isNonEmptyArray(data)) {
+            return data[0];
+        }
+        return lodash_1.default.first(data);
+    }
+    static isNonEmptyArray(data) {
+        if (lodash_1.default.isNil(data)) {
+            return false;
+        }
+        return data.length > 0;
+    }
+    static isUniformArray(value, itemGuard) {
+        if (!lodash_1.default.isArray(value)) {
+            return false;
+        }
+        if (value.length === 0) {
+            return true;
+        }
+        if (itemGuard !== undefined) {
+            return value.every((item) => itemGuard(item));
+        }
+        const valueTypes = new Set(value.map((item) => typeof item));
+        return valueTypes.size === 1;
+    }
+}
+exports.ArrayUtils = ArrayUtils;
+//# sourceMappingURL=ArrayUtils.js.map

package/dist/ArrayUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArrayUtils.js","sourceRoot":"","sources":["../src/ArrayUtils.ts"],"names":[],"mappings":";;;;;;AAAA,+EAA4E;AAC5E,oDAAuB;AAYvB,MAAa,UAAU;IAOZ,MAAM,CAAC,YAAY,CAAI,IAAS;QACnC,IAAI,UAAU,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,MAAM,IAAI,+BAAc,CAAC,yBAAyB,CAAC,CAAC;IACxD,CAAC;IAEM,MAAM,CAAC,KAAK,CAAmB,IAA0B;QAC5D,IAAI,UAAU,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC,CAAC,CAAoB,CAAC;QACtC,CAAC;QAED,OAAO,gBAAC,CAAC,KAAK,CAAC,IAAI,CAAoB,CAAC;IAC5C,CAAC;IAEM,MAAM,CAAC,eAAe,CAAI,IAA4B;QACzD,IAAI,gBAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3B,CAAC;IAEM,MAAM,CAAC,cAAc,CAAI,KAAc,EAAE,SAAwC;QACpF,IAAI,CAAC,gBAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACpB,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,IAAa,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3D,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAa,EAAE,EAAE,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;QAEtE,OAAO,UAAU,CAAC,IAAI,KAAK,CAAC,CAAC;IACjC,CAAC;CACJ;AAhDD,gCAgDC"}

package/dist/AssertionUtils.d.ts

@@ -0,0 +1,11 @@
+import { EntityType } from '@coast/core-types/common/EntityType';
+import { CoastException } from '@coast/core-types/exception/CoastException';
+export declare class AssertionUtils {
+    static assertIsDefined<T>(x: T | null | undefined, error?: CoastException | string): asserts x is T;
+    static assertValidEntityReference<T extends object>(entity: T | null | undefined, entityType: EntityType, options?: {
+        id?: string;
+        message?: string;
+    }): asserts entity is T;
+    static assert(value: unknown, error?: CoastException | string): asserts value;
+    static assertUnreachable(x: never): never;
+}

package/dist/AssertionUtils.js

@@ -0,0 +1,51 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssertionUtils = void 0;
+const GeneralErrorCode_1 = require("@coast/core-types/error/GeneralErrorCode");
+const AssertionFailedException_1 = require("@coast/core-types/exception/AssertionFailedException");
+const CoastException_1 = require("@coast/core-types/exception/CoastException");
+const InvalidEntityReferenceException_1 = require("@coast/core-types/exception/InvalidEntityReferenceException");
+const NotDefinedException_1 = require("@coast/core-types/exception/NotDefinedException");
+const DeepLogObject_1 = require("@coast/service-common/logger/DeepLogObject");
+const lodash_1 = __importDefault(require("lodash"));
+const node_assert_1 = __importDefault(require("node:assert"));
+class AssertionUtils {
+    static assertIsDefined(x, error) {
+        if (lodash_1.default.isNil(x)) {
+            if (error instanceof CoastException_1.CoastException) {
+                throw error;
+            }
+            throw new NotDefinedException_1.NotDefinedException(error);
+        }
+    }
+    static assertValidEntityReference(entity, entityType, options = {}) {
+        AssertionUtils.assertIsDefined(entity, new InvalidEntityReferenceException_1.InvalidEntityReferenceException({
+            entityType,
+            id: options?.id,
+            message: options?.message,
+        }));
+    }
+    static assert(value, error) {
+        try {
+            (0, node_assert_1.default)(value);
+        }
+        catch {
+            if (error instanceof CoastException_1.CoastException) {
+                throw error;
+            }
+            throw new AssertionFailedException_1.AssertionFailedException(error);
+        }
+    }
+    static assertUnreachable(x) {
+        throw new CoastException_1.CoastException({
+            message: 'Unexpected unreachable value',
+            code: GeneralErrorCode_1.GeneralErrorCode.INTERNAL_ERROR,
+            additionalData: (0, DeepLogObject_1.DeepLogObject)(x),
+        });
+    }
+}
+exports.AssertionUtils = AssertionUtils;
+//# sourceMappingURL=AssertionUtils.js.map

package/dist/AssertionUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssertionUtils.js","sourceRoot":"","sources":["../src/AssertionUtils.ts"],"names":[],"mappings":";;;;;;AACA,+EAA4E;AAC5E,mGAAgG;AAChG,+EAA4E;AAC5E,iHAA8G;AAC9G,yFAAsF;AACtF,8EAA2E;AAC3E,oDAAuB;AACvB,8DAAqC;AAErC,MAAa,cAAc;IACvB,MAAM,CAAC,eAAe,CAAI,CAAuB,EAAE,KAA+B;QAC9E,IAAI,gBAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACb,IAAI,KAAK,YAAY,+BAAc,EAAE,CAAC;gBAClC,MAAM,KAAK,CAAC;YAChB,CAAC;YACD,MAAM,IAAI,yCAAmB,CAAC,KAAK,CAAC,CAAC;QACzC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,0BAA0B,CAC7B,MAA4B,EAC5B,UAAsB,EACtB,UAA6C,EAAE;QAE/C,cAAc,CAAC,eAAe,CAC1B,MAAM,EACN,IAAI,iEAA+B,CAAC;YAChC,UAAU;YACV,EAAE,EAAE,OAAO,EAAE,EAAE;YACf,OAAO,EAAE,OAAO,EAAE,OAAO;SAC5B,CAAC,CACL,CAAC;IACN,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,KAAc,EAAE,KAA+B;QACzD,IAAI,CAAC;YACD,IAAA,qBAAU,EAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACL,IAAI,KAAK,YAAY,+BAAc,EAAE,CAAC;gBAClC,MAAM,KAAK,CAAC;YAChB,CAAC;YACD,MAAM,IAAI,mDAAwB,CAAC,KAAK,CAAC,CAAC;QAC9C,CAAC;IACL,CAAC;IAED,MAAM,CAAC,iBAAiB,CAAC,CAAQ;QAC7B,MAAM,IAAI,+BAAc,CAAC;YACrB,OAAO,EAAE,8BAA8B;YACvC,IAAI,EAAE,mCAAgB,CAAC,cAAc;YACrC,cAAc,EAAE,IAAA,6BAAa,EAAC,CAAC,CAAC;SACnC,CAAC,CAAC;IACP,CAAC;CACJ;AA3CD,wCA2CC"}

package/dist/test/ArrayUtilsTest.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/ArrayUtilsTest.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const CoastException_1 = require("@coast/core-types/exception/CoastException");
+const ArrayUtils_1 = require("../ArrayUtils");
+describe('ArrayUtils', () => {
+    describe('liftNonEmpty', () => {
+        it('returns the same array as a NonEmptyArray when given a non-empty array', () => {
+            const input = [1, 2, 3];
+            const result = ArrayUtils_1.ArrayUtils.liftNonEmpty(input);
+            expect(result).toEqual([1, 2, 3]);
+        });
+        it('returns a single-element array', () => {
+            const input = ['only'];
+            const result = ArrayUtils_1.ArrayUtils.liftNonEmpty(input);
+            expect(result).toEqual(['only']);
+        });
+        it('throws a CoastException when given an empty array', () => {
+            expect(() => ArrayUtils_1.ArrayUtils.liftNonEmpty([])).toThrow(CoastException_1.CoastException);
+            expect(() => ArrayUtils_1.ArrayUtils.liftNonEmpty([])).toThrow('Cannot lift empty array');
+        });
+    });
+    describe('first', () => {
+        it('returns the first element of a non-empty array', () => {
+            expect(ArrayUtils_1.ArrayUtils.first([10, 20, 30])).toEqual(10);
+        });
+        it('returns the first element of a single-element array', () => {
+            expect(ArrayUtils_1.ArrayUtils.first(['hello'])).toEqual('hello');
+        });
+        it('returns undefined for an empty array', () => {
+            expect(ArrayUtils_1.ArrayUtils.first([])).toBeUndefined();
+        });
+        it('returns undefined when given undefined', () => {
+            expect(ArrayUtils_1.ArrayUtils.first(undefined)).toBeUndefined();
+        });
+        it('returns undefined when given null', () => {
+            expect(ArrayUtils_1.ArrayUtils.first(null)).toBeUndefined();
+        });
+    });
+    describe('isNonEmptyArray', () => {
+        it('returns true for a non-empty array', () => {
+            expect(ArrayUtils_1.ArrayUtils.isNonEmptyArray([1, 2, 3])).toEqual(true);
+        });
+        it('returns true for a single-element array', () => {
+            expect(ArrayUtils_1.ArrayUtils.isNonEmptyArray(['item'])).toEqual(true);
+        });
+        it('returns false for an empty array', () => {
+            expect(ArrayUtils_1.ArrayUtils.isNonEmptyArray([])).toEqual(false);
+        });
+        it('returns false for null', () => {
+            expect(ArrayUtils_1.ArrayUtils.isNonEmptyArray(null)).toEqual(false);
+        });
+        it('returns false for undefined', () => {
+            expect(ArrayUtils_1.ArrayUtils.isNonEmptyArray(undefined)).toEqual(false);
+        });
+    });
+    describe('isUniformArray', () => {
+        it('returns true for an empty array', () => {
+            expect(ArrayUtils_1.ArrayUtils.isUniformArray([])).toEqual(true);
+        });
+        it('returns false for a non-array value', () => {
+            expect(ArrayUtils_1.ArrayUtils.isUniformArray('not an array')).toEqual(false);
+        });
+        it('returns false for null', () => {
+            expect(ArrayUtils_1.ArrayUtils.isUniformArray(null)).toEqual(false);
+        });
+        it('returns false for undefined', () => {
+            expect(ArrayUtils_1.ArrayUtils.isUniformArray(undefined)).toEqual(false);
+        });
+        it('returns true for an array of uniform string types', () => {
+            expect(ArrayUtils_1.ArrayUtils.isUniformArray(['a', 'b', 'c'])).toEqual(true);
+        });
+        it('returns true for an array of uniform number types', () => {
+            expect(ArrayUtils_1.ArrayUtils.isUniformArray([1, 2, 3])).toEqual(true);
+        });
+        it('returns false for an array of mixed types', () => {
+            expect(ArrayUtils_1.ArrayUtils.isUniformArray([1, 'two', 3])).toEqual(false);
+        });
+        it('returns false for an array mixing numbers and booleans', () => {
+            expect(ArrayUtils_1.ArrayUtils.isUniformArray([1, true, 3])).toEqual(false);
+        });
+        describe('with itemGuard', () => {
+            const isString = (item) => typeof item === 'string';
+            const isNumber = (item) => typeof item === 'number';
+            it('returns true when all items satisfy the guard', () => {
+                expect(ArrayUtils_1.ArrayUtils.isUniformArray(['a', 'b', 'c'], isString)).toEqual(true);
+            });
+            it('returns false when any item fails the guard', () => {
+                expect(ArrayUtils_1.ArrayUtils.isUniformArray(['a', 1, 'c'], isString)).toEqual(false);
+            });
+            it('returns true for an empty array regardless of guard', () => {
+                expect(ArrayUtils_1.ArrayUtils.isUniformArray([], isNumber)).toEqual(true);
+            });
+            it('returns true when all items satisfy a number guard', () => {
+                expect(ArrayUtils_1.ArrayUtils.isUniformArray([1, 2, 3], isNumber)).toEqual(true);
+            });
+            it('narrowing: correctly types result as string[] when guard passes', () => {
+                const value = ['x', 'y'];
+                if (ArrayUtils_1.ArrayUtils.isUniformArray(value, isString)) {
+                    expect(value[0]).toEqual('x');
+                }
+            });
+        });
+    });
+});
+//# sourceMappingURL=ArrayUtilsTest.js.map

package/dist/test/ArrayUtilsTest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArrayUtilsTest.js","sourceRoot":"","sources":["../../src/test/ArrayUtilsTest.ts"],"names":[],"mappings":"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"}

package/dist/test/AssertionUtilsTest.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/AssertionUtilsTest.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const EntityType_1 = require("@coast/core-types/common/EntityType");
+const EntityTypeLabels_1 = require("@coast/core-types/common/EntityTypeLabels");
+const AssertionFailedException_1 = require("@coast/core-types/exception/AssertionFailedException");
+const CoastException_1 = require("@coast/core-types/exception/CoastException");
+const InvalidEntityReferenceException_1 = require("@coast/core-types/exception/InvalidEntityReferenceException");
+const NotDefinedException_1 = require("@coast/core-types/exception/NotDefinedException");
+const assertType_1 = require("@coast/service-common/types/assertType");
+const common_test_1 = require("@paradoxical-io/common-test");
+const AssertionUtils_1 = require("../AssertionUtils");
+describe('AssertionUtils', () => {
+    describe('assertIsDefined', () => {
+        it('should throw if value is not defined', () => {
+            const x = undefined;
+            try {
+                AssertionUtils_1.AssertionUtils.assertIsDefined(x);
+            }
+            catch (error) {
+                expect(error).toBeInstanceOf(NotDefinedException_1.NotDefinedException);
+                (0, common_test_1.safeExpect)(error.message).toEqual('Value is not defined');
+            }
+        });
+        it('should use custom error message', () => {
+            const x = undefined;
+            try {
+                AssertionUtils_1.AssertionUtils.assertIsDefined(x, 'x should exist...');
+            }
+            catch (error) {
+                expect(error).toBeInstanceOf(NotDefinedException_1.NotDefinedException);
+                (0, common_test_1.safeExpect)(error.message).toEqual('x should exist...');
+            }
+        });
+        it('should use custom Exception', () => {
+            const x = undefined;
+            try {
+                AssertionUtils_1.AssertionUtils.assertIsDefined(x, new CoastException_1.CoastException('custom exception'));
+            }
+            catch (error) {
+                expect(error).toBeInstanceOf(CoastException_1.CoastException);
+                (0, common_test_1.safeExpect)(error.message).toEqual('custom exception');
+            }
+        });
+        it('should not throw and should type narrow if value is defined', () => {
+            const x = '';
+            (0, assertType_1.assertType)();
+            AssertionUtils_1.AssertionUtils.assertIsDefined(x);
+            (0, assertType_1.assertType)();
+        });
+    });
+    describe('assert', () => {
+        it('should throw AssertionFailedException if value is falsy', () => {
+            try {
+                AssertionUtils_1.AssertionUtils.assert(false);
+            }
+            catch (error) {
+                expect(error).toBeInstanceOf(AssertionFailedException_1.AssertionFailedException);
+            }
+        });
+        it('should use custom error message', () => {
+            try {
+                AssertionUtils_1.AssertionUtils.assert(false, 'value must be truthy');
+            }
+            catch (error) {
+                expect(error).toBeInstanceOf(AssertionFailedException_1.AssertionFailedException);
+                (0, common_test_1.safeExpect)(error.message).toEqual('value must be truthy');
+            }
+        });
+        it('should use custom CoastException', () => {
+            try {
+                AssertionUtils_1.AssertionUtils.assert(false, new CoastException_1.CoastException('custom coast exception'));
+            }
+            catch (error) {
+                expect(error).toBeInstanceOf(CoastException_1.CoastException);
+                (0, common_test_1.safeExpect)(error.message).toEqual('custom coast exception');
+            }
+        });
+        it('should not throw if value is truthy', () => {
+            (0, common_test_1.safeExpect)(() => AssertionUtils_1.AssertionUtils.assert(true)).not.toThrow();
+            (0, common_test_1.safeExpect)(() => AssertionUtils_1.AssertionUtils.assert(1)).not.toThrow();
+            (0, common_test_1.safeExpect)(() => AssertionUtils_1.AssertionUtils.assert('hello')).not.toThrow();
+            (0, common_test_1.safeExpect)(() => AssertionUtils_1.AssertionUtils.assert({})).not.toThrow();
+        });
+        it('should type narrow to exclude falsy', () => {
+            const x = 'hello';
+            (0, assertType_1.assertType)();
+            AssertionUtils_1.AssertionUtils.assert(x);
+            (0, assertType_1.assertType)();
+        });
+    });
+    describe('assertValidEntityReference', () => {
+        it('should throw if value is not defined', () => {
+            const x = undefined;
+            try {
+                AssertionUtils_1.AssertionUtils.assertValidEntityReference(x, EntityType_1.EntityType.WORKFLOW_ENTITY);
+            }
+            catch (error) {
+                expect(error).toBeInstanceOf(InvalidEntityReferenceException_1.InvalidEntityReferenceException);
+                (0, common_test_1.safeExpect)(error.message).toEqual(`Invalid entity reference: ${EntityTypeLabels_1.EntityTypeLabels[EntityType_1.EntityType.WORKFLOW_ENTITY]} not found`);
+                (0, common_test_1.safeExpect)(error.additionalData).toMatchObject({
+                    entityType: EntityType_1.EntityType.WORKFLOW_ENTITY,
+                });
+            }
+        });
+        it('should use custom error message', () => {
+            const x = undefined;
+            try {
+                AssertionUtils_1.AssertionUtils.assertValidEntityReference(x, EntityType_1.EntityType.WORKFLOW_ENTITY, {
+                    message: 'x should exist...',
+                    id: 'abc-123',
+                });
+            }
+            catch (error) {
+                expect(error).toBeInstanceOf(InvalidEntityReferenceException_1.InvalidEntityReferenceException);
+                (0, common_test_1.safeExpect)(error.message).toEqual('x should exist...');
+                (0, common_test_1.safeExpect)(error.additionalData).toMatchObject({
+                    entityType: EntityType_1.EntityType.WORKFLOW_ENTITY,
+                    id: 'abc-123',
+                });
+            }
+        });
+        it('should not throw and should type narrow if value is defined', () => {
+            const x = { id: 'abc' };
+            (0, assertType_1.assertType)();
+            AssertionUtils_1.AssertionUtils.assertValidEntityReference(x, EntityType_1.EntityType.COMPONENT);
+            (0, assertType_1.assertType)();
+        });
+    });
+});
+//# sourceMappingURL=AssertionUtilsTest.js.map

package/dist/test/AssertionUtilsTest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssertionUtilsTest.js","sourceRoot":"","sources":["../../src/test/AssertionUtilsTest.ts"],"names":[],"mappings":"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"}

package/jest.config.js

@@ -1,3 +1,4 @@
+
 module.exports = {
     preset: 'ts-jest',
     testEnvironment: 'node',

package/package.json

@@ -1,9 +1,11 @@
 {
   "name": "@coast/core-utils",
-  "version": "0.0.3",
+  "version": "0.0.6",
   "author": "Coast Engineering",
   "license": "MIT",
   "dependencies": {
+    "@coast/core-types": "0.0.16",
+    "@coast/service-common": "^2.0.65",
     "lodash": "^4.17.21"
   },
   "scripts": {
@@ -20,6 +22,7 @@
     "strict:count": "echo \"$(grep -l \"ts-strict-ignore\" **/*.ts | wc -l) non-strict files\""
   },
   "devDependencies": {
+    "@paradoxical-io/common-test": "^2.7.0",
     "@types/lodash": "^4.17.7",
     "cross-env": "^7.0.3",
     "jest": "^29.7.0",

package/src/ArrayUtils.ts

@@ -0,0 +1,62 @@
+import { CoastException } from '@coast/core-types/exception/CoastException';
+import _ from 'lodash';
+
+import { NonEmptyArray } from './NonEmptyArray';
+
+/**
+ * Determine the first element type of an array. If the array is a regular array type the element type is nullable when acting on
+ * indexing/first. If the array is a non-empty array type the element type is not nullable for the first element.
+ *
+ * This allows for safe indexing of the first element of a non-empty array type without needing to check for null or undefined.
+ */
+type FirstElement<ARR> = ARR extends NonEmptyArray<infer U> ? U : ARR extends Array<infer U> ? U | null | undefined : never;
+
+export class ArrayUtils {
+    /**
+     * Lift an array into a non-empty array. Checking ahead of time needs to be done to ensure this is valid as this puts
+     * the responsibility onto a user of knowing that the array is non-empty.
+     *
+     * If an empty array is attempted to be lifted this call will throw an error.
+     */
+    public static liftNonEmpty<T>(data: T[]): NonEmptyArray<T> {
+        if (ArrayUtils.isNonEmptyArray(data)) {
+            return data;
+        }
+
+        throw new CoastException('Cannot lift empty array');
+    }
+
+    public static first<T, Y extends T[]>(data: Y | null | undefined): FirstElement<Y> {
+        if (ArrayUtils.isNonEmptyArray(data)) {
+            return data[0] as FirstElement<Y>;
+        }
+
+        return _.first(data) as FirstElement<Y>;
+    }
+
+    public static isNonEmptyArray<T>(data: T[] | null | undefined): data is NonEmptyArray<T> {
+        if (_.isNil(data)) {
+            return false;
+        }
+
+        return data.length > 0;
+    }
+
+    public static isUniformArray<E>(value: unknown, itemGuard?: (item: unknown) => item is E): value is E[] {
+        if (!_.isArray(value)) {
+            return false;
+        }
+
+        if (value.length === 0) {
+            return true;
+        }
+
+        if (itemGuard !== undefined) {
+            return value.every((item: unknown) => itemGuard(item));
+        }
+
+        const valueTypes = new Set(value.map((item: unknown) => typeof item));
+
+        return valueTypes.size === 1;
+    }
+}

package/src/AssertionUtils.ts

@@ -0,0 +1,54 @@
+import { EntityType } from '@coast/core-types/common/EntityType';
+import { GeneralErrorCode } from '@coast/core-types/error/GeneralErrorCode';
+import { AssertionFailedException } from '@coast/core-types/exception/AssertionFailedException';
+import { CoastException } from '@coast/core-types/exception/CoastException';
+import { InvalidEntityReferenceException } from '@coast/core-types/exception/InvalidEntityReferenceException';
+import { NotDefinedException } from '@coast/core-types/exception/NotDefinedException';
+import { DeepLogObject } from '@coast/service-common/logger/DeepLogObject';
+import _ from 'lodash';
+import nodeAssert from 'node:assert';
+
+export class AssertionUtils {
+    static assertIsDefined<T>(x: T | null | undefined, error?: CoastException | string): asserts x is T {
+        if (_.isNil(x)) {
+            if (error instanceof CoastException) {
+                throw error;
+            }
+            throw new NotDefinedException(error);
+        }
+    }
+
+    static assertValidEntityReference<T extends object>(
+        entity: T | null | undefined,
+        entityType: EntityType,
+        options: { id?: string; message?: string } = {}
+    ): asserts entity is T {
+        AssertionUtils.assertIsDefined(
+            entity,
+            new InvalidEntityReferenceException({
+                entityType,
+                id: options?.id,
+                message: options?.message,
+            })
+        );
+    }
+
+    static assert(value: unknown, error?: CoastException | string): asserts value {
+        try {
+            nodeAssert(value);
+        } catch {
+            if (error instanceof CoastException) {
+                throw error;
+            }
+            throw new AssertionFailedException(error);
+        }
+    }
+
+    static assertUnreachable(x: never): never {
+        throw new CoastException({
+            message: 'Unexpected unreachable value',
+            code: GeneralErrorCode.INTERNAL_ERROR,
+            additionalData: DeepLogObject(x),
+        });
+    }
+}