healer-man/scripts/runewaker-pipeline/lib/recipe.mjs

import { readFile, stat } from "node:fs/promises";
import path from "node:path";
import { fileURLToPath } from "node:url";

export const pipelineDirectory = path.resolve(
  path.dirname(fileURLToPath(import.meta.url)),
  "..",
);
export const projectRoot = path.resolve(pipelineDirectory, "../..");

export function optionValue(argv, name, fallback = null) {
  const equals = argv.find((value) => value.startsWith(name + "="));
  if (equals) return equals.slice(name.length + 1);
  const index = argv.indexOf(name);
  if (index >= 0 && argv[index + 1] && !argv[index + 1].startsWith("--")) {
    return argv[index + 1];
  }
  return fallback;
}

export function hasFlag(argv, name) {
  return argv.includes(name);
}

export function resolveProject(value) {
  return path.resolve(projectRoot, value);
}

export function projectPath(value) {
  return path.relative(projectRoot, value).split(path.sep).join("/");
}

export async function readJson(file) {
  return JSON.parse((await readFile(file, "utf8")).replace(/^\uFEFF/, ""));
}

export async function exists(file) {
  try {
    await stat(file);
    return true;
  } catch {
    return false;
  }
}

export function slugify(value) {
  return String(value ?? "")
    .normalize("NFKD")
    .replace(/[\u0300-\u036f]/g, "")
    .replace(/[^a-zA-Z0-9]+/g, "-")
    .replace(/^-+|-+$/g, "")
    .toLowerCase();
}

export function camelCase(value) {
  const words = slugify(value).split("-").filter(Boolean);
  return words.map((word, index) => (
    index === 0 ? word : word[0].toUpperCase() + word.slice(1)
  )).join("");
}

export function constantCase(value) {
  return slugify(value).replaceAll("-", "_").toUpperCase();
}

export function normalizedResourcePath(value) {
  return String(value ?? "")
    .replaceAll("/", "\\")
    .replace(/^\\+/, "")
    .toLowerCase();
}

export function sourceRootFor(recipe) {
  return path.resolve(
    process.env[recipe.source.rootEnvironmentVariable]
      ?? path.join(projectRoot, recipe.source.relativeDefault),
  );
}

export function recipeArgument(argv, fallbackFile) {
  const explicit = optionValue(argv, "--recipe");
  return explicit ? path.resolve(projectRoot, explicit) : path.resolve(fallbackFile);
}

function assertObject(value, label) {
  if (!value || typeof value !== "object" || Array.isArray(value)) {
    throw new Error(label + " must be an object.");
  }
}

function assertString(value, label) {
  if (typeof value !== "string" || !value.trim()) {
    throw new Error(label + " must be a non-empty string.");
  }
}

export function validateEnvironmentRecipe(recipe, file = "environment recipe") {
  assertObject(recipe, file);
  assertString(recipe.slug, file + ".slug");
  assertString(recipe.title, file + ".title");
  assertObject(recipe.source, file + ".source");
  for (const key of [
    "rootEnvironmentVariable",
    "relativeDefault",
    "resourceRoot",
    "wdb",
    "model",
    "dungeonConfig",
    "dungeonConfigId",
  ]) {
    assertString(recipe.source[key], file + ".source." + key);
  }
  assertObject(recipe.coordinateSystem, file + ".coordinateSystem");
  if (!(Number(recipe.coordinateSystem.metersPerSourceUnit) > 0)) {
    throw new Error(file + ".coordinateSystem.metersPerSourceUnit must be positive.");
  }
  assertObject(recipe.navigation, file + ".navigation");
  return recipe;
}

export function validatePopulationRecipe(recipe, file = "population recipe") {
  assertObject(recipe, file);
  assertString(recipe.dungeonId, file + ".dungeonId");
  if (!Number.isInteger(recipe.zoneId) || recipe.zoneId <= 0) {
    throw new Error(file + ".zoneId must be a positive integer.");
  }
  assertObject(recipe.files, file + ".files");
  for (const key of [
    "snapshot",
    "generatedSource",
    "report",
    "environmentMetadata",
    "navigation",
    "actorManifest",
    "actorOutput",
  ]) {
    assertString(recipe.files[key], file + ".files." + key);
  }
  assertObject(recipe.source, file + ".source");
  if (!Array.isArray(recipe.actors) || !Array.isArray(recipe.templates)) {
    throw new Error(file + " must contain actors and templates arrays.");
  }
  const actorIds = new Set();
  for (const actor of recipe.actors) {
    assertString(actor.id, file + " actor id");
    assertString(actor.sourceModel, file + " actor sourceModel");
    if (actorIds.has(actor.id)) throw new Error("Duplicate actor id " + actor.id + ".");
    actorIds.add(actor.id);
  }
  const templateIds = new Set();
  const classifications = new Set(["combat", "boss", "deferred-object", "unclassified"]);
  for (const template of recipe.templates) {
    if (!Number.isInteger(template.id)) throw new Error("Template ids must be integers.");
    if (templateIds.has(template.id)) throw new Error("Duplicate template id " + template.id + ".");
    templateIds.add(template.id);
    if (!classifications.has(template.classification)) {
      throw new Error("Unsupported classification " + template.classification + ".");
    }
    if (["combat", "boss"].includes(template.classification)
      && !actorIds.has(template.actor)
      && template.proceduralFallback !== true) {
      throw new Error("Combat template " + template.id + " has no mapped actor or explicit procedural fallback.");
    }
  }
  return recipe;
}

export async function loadEnvironmentRecipe(argv, fallbackFile) {
  const file = recipeArgument(argv, fallbackFile);
  return { file, recipe: validateEnvironmentRecipe(await readJson(file), projectPath(file)) };
}

export async function loadPopulationRecipe(argv, fallbackFile) {
  const file = recipeArgument(argv, fallbackFile);
  return { file, recipe: validatePopulationRecipe(await readJson(file), projectPath(file)) };
}

export function publicUrlFor(projectFile) {
  const publicRoot = path.join(projectRoot, "public");
  const relative = path.relative(publicRoot, projectFile);
  if (relative.startsWith("..") || path.isAbsolute(relative)) {
    throw new Error("Runtime creature assets must be written beneath public/: " + projectFile);
  }
  return "/" + relative.split(path.sep).join("/");
}