healer-man/server/manastorm-config.mjs

export const MANASTORM_ADMIN_CONFIG_SCHEMA_VERSION = 1;

export const DEFAULT_MANASTORM_ADMIN_CONFIG = Object.freeze({
  schemaVersion: MANASTORM_ADMIN_CONFIG_SCHEMA_VERSION,
  global: Object.freeze({
    enabled: true,
    levelingEnabled: true,
    endgameEnabled: true,
    affixesEnabled: true,
    chaoticLinkEnabled: true,
    milestoneEncountersEnabled: true,
  }),
  dungeonSpawns: Object.freeze({}),
  bosses: Object.freeze({}),
});

const BOSS_STATUSES = new Set(["ready", "needs-tested", "not-ready"]);
const MAX_RECORDS = 10_000;
const MAX_ID_LENGTH = 256;

function invalid(message) {
  const error = new Error(message);
  error.code = "invalid_manastorm_config";
  return error;
}

function record(value, label) {
  if (!value || typeof value !== "object" || Array.isArray(value)) {
    throw invalid(`${label} must be an object.`);
  }
  return value;
}

function identifier(value, label) {
  if (typeof value !== "string" || !value.trim() || value.length > MAX_ID_LENGTH) {
    throw invalid(`${label} must be a non-empty string no longer than ${MAX_ID_LENGTH} characters.`);
  }
  return value.trim();
}

function optionalIdentifier(value, label) {
  return value === undefined || value === null ? undefined : identifier(value, label);
}

function finiteNumber(value, label) {
  if (typeof value !== "number" || !Number.isFinite(value)) {
    throw invalid(`${label} must be a finite number.`);
  }
  return value;
}

function vector(value, label) {
  if (!Array.isArray(value) || value.length !== 3) {
    throw invalid(`${label} must contain exactly three coordinates.`);
  }
  return value.map((coordinate, index) => finiteNumber(coordinate, `${label}[${index}]`));
}

function worldSpawn(value, label) {
  const input = record(value, label);
  return {
    footPosition: vector(input.footPosition, `${label}.footPosition`),
    yaw: finiteNumber(input.yaw, `${label}.yaw`),
  };
}

function boolean(value, label) {
  if (typeof value !== "boolean") throw invalid(`${label} must be a boolean.`);
  return value;
}

function normalizeGlobal(value) {
  const input = record(value, "config.global");
  return {
    enabled: boolean(input.enabled, "config.global.enabled"),
    levelingEnabled: boolean(input.levelingEnabled, "config.global.levelingEnabled"),
    endgameEnabled: boolean(input.endgameEnabled, "config.global.endgameEnabled"),
    affixesEnabled: boolean(input.affixesEnabled, "config.global.affixesEnabled"),
    chaoticLinkEnabled: boolean(input.chaoticLinkEnabled, "config.global.chaoticLinkEnabled"),
    milestoneEncountersEnabled: boolean(
      input.milestoneEncountersEnabled,
      "config.global.milestoneEncountersEnabled",
    ),
  };
}

function normalizeStage(value, label) {
  const input = record(value, label);
  const linkedMobRuntimeIds = Array.isArray(input.linkedMobRuntimeIds)
    ? input.linkedMobRuntimeIds.map((id, index) => identifier(id, `${label}.linkedMobRuntimeIds[${index}]`))
    : (() => { throw invalid(`${label}.linkedMobRuntimeIds must be an array.`); })();
  if (new Set(linkedMobRuntimeIds).size !== linkedMobRuntimeIds.length) {
    throw invalid(`${label}.linkedMobRuntimeIds must not contain duplicates.`);
  }
  const requiredKillCount = finiteNumber(input.requiredKillCount, `${label}.requiredKillCount`);
  if (!Number.isInteger(requiredKillCount) || requiredKillCount < 0 || requiredKillCount > linkedMobRuntimeIds.length) {
    throw invalid(`${label}.requiredKillCount must be an integer between zero and the linked mob count.`);
  }
  const mapId = finiteNumber(input.mapId, `${label}.mapId`);
  if (!Number.isInteger(mapId) || mapId <= 0) throw invalid(`${label}.mapId must be a positive integer.`);
  return {
    dungeonId: identifier(input.dungeonId, `${label}.dungeonId`),
    mapId,
    bossRuntimeId: identifier(input.bossRuntimeId, `${label}.bossRuntimeId`),
    bossEntityId: identifier(input.bossEntityId, `${label}.bossEntityId`),
    bossName: identifier(input.bossName, `${label}.bossName`),
    ...(optionalIdentifier(input.baseStageId, `${label}.baseStageId`)
      ? { baseStageId: optionalIdentifier(input.baseStageId, `${label}.baseStageId`) }
      : {}),
    ...(optionalIdentifier(input.assetPackageId, `${label}.assetPackageId`)
      ? { assetPackageId: optionalIdentifier(input.assetPackageId, `${label}.assetPackageId`) }
      : {}),
    bossPosition: vector(input.bossPosition, `${label}.bossPosition`),
    bossYaw: finiteNumber(input.bossYaw, `${label}.bossYaw`),
    groupSpawn: worldSpawn(input.groupSpawn, `${label}.groupSpawn`),
    portalPosition: vector(input.portalPosition, `${label}.portalPosition`),
    linkedMobRuntimeIds,
    requiredKillCount,
  };
}

function normalizeDictionary(value, label, normalizeValue) {
  const input = record(value, label);
  const entries = Object.entries(input);
  if (entries.length > MAX_RECORDS) throw invalid(`${label} contains too many records.`);
  return Object.fromEntries(entries.map(([key, entry]) => [
    identifier(key, `${label} key`),
    normalizeValue(entry, `${label}.${key}`),
  ]));
}

export function normalizeManastormAdminConfig(value) {
  const input = record(value, "config");
  if (input.schemaVersion !== MANASTORM_ADMIN_CONFIG_SCHEMA_VERSION) {
    throw invalid(`Unsupported Manastorm admin config schema ${String(input.schemaVersion)}.`);
  }
  const dungeonSpawns = normalizeDictionary(input.dungeonSpawns, "config.dungeonSpawns", worldSpawn);
  const bosses = normalizeDictionary(input.bosses, "config.bosses", (rawBoss, label) => {
    const boss = record(rawBoss, label);
    if (!BOSS_STATUSES.has(boss.status)) throw invalid(`${label}.status is invalid.`);
    if (boss.status === "ready" && (boss.stage === undefined || boss.stage === null)) {
      throw invalid(`${label} cannot be Ready without a complete stage.`);
    }
    return {
      status: boss.status,
      ...(boss.stage === undefined || boss.stage === null
        ? {}
        : { stage: normalizeStage(boss.stage, `${label}.stage`) }),
    };
  });
  return {
    schemaVersion: MANASTORM_ADMIN_CONFIG_SCHEMA_VERSION,
    global: normalizeGlobal(input.global),
    dungeonSpawns,
    bosses,
  };
}

export function cloneDefaultManastormAdminConfig() {
  return JSON.parse(JSON.stringify(DEFAULT_MANASTORM_ADMIN_CONFIG));
}