Function rebuildFile

packages/world-cli/src/dev.js:207–328

(file, why)

  };

  const rebuildFile = async (file, why) => {
    if (!(await exists(file))) {
      return { upserts: [], removals: removeFile(file), reports: [] };
    }

    const source = await readFile(file, "utf8");
    const sourceHash = hashSource(source);
    if (fileHashes.get(file) === sourceHash) {
      return { upserts: [], removals: [], reports: [] };
    }

    const realm = realmForFile(file);
    const override = realm ? null : targetForOverride(file, targets);
    if (!realm && !override) {
      return { upserts: [], removals: [], reports: [] };
    }
    if (override?.error) {
      process.stderr.write(`FAIL  ${why}: ${file}\n${override.error}\n\n`);
      return { upserts: [], removals: [], reports: [] };
    }

    const loaded = await loadModule(file, source);
    const upserts = [];
    const reports = [];
    const removals = [];

    if (loaded.error) {
      const message = String(loaded.error.message || loaded.error).split(
        "\n"
      )[0];
      const owned = [...builders.values()].filter(
        (builder) => builder.file === file
      );
      /* A file that has never built still gets a failure report — a broken
         file that reports nothing reads as "waiting" everywhere. Its exports
         are unknowable before it evaluates, so the failure is pinned to one
         well-known family. */
      const failed = owned.length
        ? owned.map((builder) => builder.target)
        : [
            override ?? {
              scope: "realm",
              realm,
              niche: null,
              family: "house",
              level: null,
            },
          ];
      for (const target of failed) {
        const result = install(file, target, {
          ok: false,
          sourceHash,
          realm: target.realm,
          niche: target.niche ?? null,
          family: target.family,
          level: target.level ?? null,
          errors: [message],
          warnings: [],