pleno-vue/src/composables/redCarDetector.js

/**
 * Red-car detection utilities for the customer portal.
 *
 * SENERE 7 / TRU-99: Until Mads defines the canonical rule for
 * identifying a "red car" (e.g. plate scan, color tag, manual
 * customer flag), we use a manual customer-attribute flag as the
 * default heuristic. The attribute keys that trigger the warning
 * are configurable so the rule can be tightened later without
 * touching call sites.
 */

/**
 * Default attribute keys that mark a customer as owning a red car.
 * Multiple keys are supported to give staff a few options when
 * tagging accounts in the customer-attribute editor.
 */
export const DEFAULT_RED_CAR_ATTRIBUTE_KEYS = Object.freeze([
  "isRedCar",
  "is_red_car",
  "redCar",
  "red_car",
]);

const normalizeKey = (key) => String(key ?? "").trim();

const toNormalizedKeySet = (keys) => {
  const set = new Set();
  if (!Array.isArray(keys)) {
    return set;
  }
  for (const key of keys) {
    const normalized = normalizeKey(key).toLowerCase();
    if (normalized) {
      set.add(normalized);
    }
  }
  return set;
};

/**
 * Extract the attribute key string from a single customer-attribute
 * row. Accepts both the API shape (object with `attribute`) and the
 * plain-string shorthand used in some call sites.
 *
 * @param {string|object|undefined|null} entry
 * @returns {string}
 */
export const extractAttributeKey = (entry) => {
  if (typeof entry === "string") {
    return normalizeKey(entry);
  }
  if (entry && typeof entry === "object") {
    const candidate = entry.attribute ?? entry.key ?? entry.name;
    return normalizeKey(candidate);
  }
  return "";
};

/**
 * Extract the attribute key strings from a list of customer
 * attributes. Returns an empty array for invalid input.
 *
 * @param {Array<string|object|undefined|null>|null|undefined} attributes
 * @returns {string[]}
 */
export const extractAttributeKeys = (attributes) => {
  if (!Array.isArray(attributes)) {
    return [];
  }
  const keys = [];
  for (const entry of attributes) {
    const key = extractAttributeKey(entry);
    if (key) {
      keys.push(key);
    }
  }
  return keys;
};

/**
 * Determine whether a customer should be flagged as a "red car"
 * based on their attribute list. The check is case-insensitive.
 *
 * @param {Array<string|object|undefined|null>|null|undefined} attributes
 * @param {object} [options]
 * @param {string[]} [options.attributeKeys] - attribute keys that
 *   mark a red car. Defaults to DEFAULT_RED_CAR_ATTRIBUTE_KEYS.
 * @returns {boolean}
 */
export const isRedCarCustomer = (attributes, options = {}) => {
  const keys = toNormalizedKeySet(
    options.attributeKeys ?? DEFAULT_RED_CAR_ATTRIBUTE_KEYS
  );
  if (keys.size === 0) {
    return false;
  }
  const attributeKeys = extractAttributeKeys(attributes);
  return attributeKeys.some((key) => keys.has(key.toLowerCase()));
};

/**
 * Return the configured red-car attribute keys (normalized,
 * deduplicated, lowercased). Useful for displaying the active
 * heuristic to operators.
 *
 * @param {object} [options]
 * @param {string[]} [options.attributeKeys]
 * @returns {string[]}
 */
export const getRedCarAttributeKeys = (options = {}) => {
  const keys = toNormalizedKeySet(
    options.attributeKeys ?? DEFAULT_RED_CAR_ATTRIBUTE_KEYS
  );
  return Array.from(keys);
};