Typescript Enforce Array Max Length Type

Typescript_enforceMaxLength.ts

/**
 * Enforces that an array respects a maximum length.
 *
 * @param {T[] | undefined} array - The array to validate.
 * @param {number} maxLength - The maximum length.
 * @returns {(T[] & {length: number}) | undefined} - Returns the array if valid, otherwise undefined.
 */
export function enforceMaxLength<T, N extends number>(
  array: T[] | undefined,
  maxLength: N,
): (T[] & {length: N}) | undefined {
  if (!array) {
    return undefined;
  }
  if (array.length <= maxLength) {
    return array as T[] & {length: N};
  }
  console.error(`Array exceeds maximum length of ${maxLength}`);
}