@exercode/problem-utils 4.2.5 → 4.3.0

package/dist/helpers/spawnWithLimits.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"spawnWithLimits.cjs","names":["childProcess","fs","path","os"],"sources":["../../src/helpers/spawnWithLimits.ts"],"sourcesContent":["import childProcess from 'node:child_process';\nimport fs from 'node:fs/promises';\nimport os from 'node:os';\nimport path from 'node:path';\n\nexport interface SpawnWithLimitsResult {\n  stdout: string;\n  stderr: string;\n  status: number | undefined;\n  signal: NodeJS.Signals | undefined;\n  /** Wall time measured by GNU time, or measured here until the command exited when it produced none. */\n  timeSeconds: number;\n  /**\n   * User plus system CPU time of the command and the descendants it waited for, measured by GNU\n   * time, or 0 when it produced no measurement. A run `timeout` ended is measured too, so a caller\n   * can tell a program that used up its time limit from one that waited for the CPU.\n   */\n  cpuTimeSeconds: number;\n  /**\n   * Peak resident set size measured by GNU time, or 0 when it produced no measurement. GNU time\n   * measures its child `timeout` and the descendants it waited for, so the value is at least\n   * `timeout`'s own footprint (about 1 MiB), which only shows for the smallest native programs.\n   */\n  memoryBytes: number;\n  /** The note GNU time adds when the command exits abnormally, e.g. `Command terminated by signal 11`. */\n  timeCommandMessage: string | undefined;\n  timedOut: boolean;\n  outputLimitExceeded: boolean;\n}\n\nconst killGracePeriodMilliseconds = 1000;\nconst MIN_TIMEOUT_SECONDS = 0.001;\n// GNU `timeout` exits with 124 after ending a run at its limit, or with 128 + SIGKILL when the run\n// ignored its SIGTERM and it had to be killed after the grace period.\nconst TIMEOUT_EXIT_STATUS = 124;\nconst KILLED_AFTER_TIMEOUT_EXIT_STATUS = 137;\n// GNU time writes its record to a file this process opened and unlinked at once, handed down as fd 3\n// of the command and reopened by GNU time through `/dev/fd`: the command runs as the same OS user,\n// so a record reachable by path could be swapped for a fake or for a FIFO that blocks the read.\nconst TIME_OUTPUT_FD = 3;\n// The command inherits that descriptor too, so only the tail that can hold GNU time's record is read.\nconst TIME_OUTPUT_TAIL_BYTES = 4096;\nconst timeCommand = resolveTimeCommand();\n\n/** Whether GNU time is available, i.e. whether `timeSeconds`, `cpuTimeSeconds`, and `memoryBytes` are measured at all. */\nexport const isTimeCommandAvailable = timeCommand !== undefined;\n\n// The commands run in their own sessions, so they outlive this process unless it ends them itself\n// on the way out (e.g. a preset's SIGINT handler calling `process.exit`).\nconst liveSubprocesses = new Set<childProcess.ChildProcess>();\nprocess.once('exit', () => {\n  for (const subprocess of liveSubprocesses) killSubprocessGroup(subprocess, 'SIGKILL');\n});\n\n/**\n * Runs a command in its own process group with `stdin` piped in, killing the whole group once it\n * exceeds the time or output limit, and reports the wall time, CPU time, and peak memory measured\n * by GNU time.\n */\nexport async function spawnWithLimits(\n  command: readonly [string, ...string[]],\n  context: {\n    cwd: string;\n    env: NodeJS.ProcessEnv;\n    outputLimitBytes: number;\n    stdin: string;\n    timeLimitSeconds: number;\n  }\n): Promise<SpawnWithLimitsResult> {\n  const timeOutput = timeCommand === undefined ? undefined : await openUnlinkedFile('exercode-time-');\n  try {\n    const detached = process.platform !== 'win32';\n    // The command runs in its own session so the group kill below cannot hit this process, but that\n    // also puts it out of reach of whoever kills this process. GNU `timeout` keeps the run bounded\n    // in that case, and it is what normally ends a run at its limit: GNU time wraps it, so a run\n    // that hit the limit still gets its CPU time recorded (a group kill from here would take GNU\n    // time down with the command), and `--foreground` keeps the command in this group so the kill\n    // below still reaches every descendant. The timers below only back `timeout` up. Should this\n    // process die first, `timeout` ends the command alone (`--foreground` signals no descendant),\n    // an accepted gap: the judge server sweeps every process of the request's sandbox user anyway.\n    const boundedCommand: readonly [string, ...string[]] = detached\n      ? [\n          'timeout',\n          '--foreground',\n          '-k',\n          String(killGracePeriodMilliseconds / 1000),\n          // A zero duration would disable `timeout`; the front matter allows a zero time limit.\n          String(Math.max(context.timeLimitSeconds, MIN_TIMEOUT_SECONDS)),\n          ...command,\n        ]\n      : command;\n    const spawnedCommand: readonly [string, ...string[]] =\n      timeCommand === undefined\n        ? boundedCommand\n        : [...timeCommand, `--output=/dev/fd/${TIME_OUTPUT_FD}`, ...boundedCommand];\n    // `timeout` sends SIGKILL a grace period after its SIGTERM; the timers here fire once even that\n    // should have ended the run.\n    const timeLimitMilliseconds = detached\n      ? context.timeLimitSeconds * 1000 + 2 * killGracePeriodMilliseconds\n      : context.timeLimitSeconds * 1000;\n    // Monotonic: a wall-clock step must not turn a run `timeout` ended into one that finished in time.\n    const startTimeMilliseconds = performance.now();\n    // The standard streams are always pipes; the type cannot express that with the extra entry.\n    const subprocess = childProcess.spawn(spawnedCommand[0], spawnedCommand.slice(1), {\n      cwd: context.cwd,\n      detached,\n      env: context.env,\n      stdio: timeOutput === undefined ? ['pipe', 'pipe', 'pipe'] : ['pipe', 'pipe', 'pipe', timeOutput.fd],\n    }) as childProcess.ChildProcessWithoutNullStreams;\n    liveSubprocesses.add(subprocess);\n\n    const stdoutChunks: Buffer[] = [];\n    const stderrChunks: Buffer[] = [];\n    let outputBytes = 0;\n    let timedOut = false;\n    let outputLimitExceeded = false;\n    let wallTimeSeconds = 0;\n    let spawnErrorMessage: string | undefined;\n\n    const appendOutputChunk = (chunks: Buffer[], chunk: Buffer): void => {\n      if (outputBytes >= context.outputLimitBytes) {\n        if (chunk.byteLength > 0) {\n          outputLimitExceeded = true;\n          killSubprocessGroup(subprocess, 'SIGKILL');\n        }\n        return;\n      }\n\n      const remainingBytes = context.outputLimitBytes - outputBytes;\n      const appendedChunk = chunk.byteLength > remainingBytes ? chunk.subarray(0, remainingBytes) : chunk;\n      chunks.push(appendedChunk);\n      outputBytes += appendedChunk.byteLength;\n\n      if (chunk.byteLength > remainingBytes) {\n        outputLimitExceeded = true;\n        killSubprocessGroup(subprocess, 'SIGKILL');\n      }\n    };\n\n    subprocess.stdout.on('data', (chunk: Buffer) => appendOutputChunk(stdoutChunks, chunk));\n    subprocess.stderr.on('data', (chunk: Buffer) => appendOutputChunk(stderrChunks, chunk));\n\n    const timeout = setTimeout(() => {\n      timedOut = true;\n      killSubprocessGroup(subprocess, 'SIGTERM');\n    }, timeLimitMilliseconds);\n    const killTimeout = setTimeout(() => {\n      if (timedOut) killSubprocessGroup(subprocess, 'SIGKILL');\n    }, timeLimitMilliseconds + killGracePeriodMilliseconds);\n    killTimeout.unref();\n\n    const { status, signal } = await new Promise<{ status: number | undefined; signal: NodeJS.Signals | undefined }>(\n      (resolve, reject) => {\n        let settled = false;\n        let pendingError: Error | undefined;\n        let closeTimeout: NodeJS.Timeout | undefined;\n        const settle = (code: number | null | undefined, exitSignal: NodeJS.Signals | null | undefined): void => {\n          if (settled) return;\n          settled = true;\n          clearTimeout(closeTimeout);\n          if (pendingError) {\n            reject(pendingError);\n            return;\n          }\n          resolve({ status: code ?? undefined, signal: exitSignal ?? undefined });\n        };\n        const failAfterClose = (error: Error): void => {\n          if (settled) return;\n          if (subprocess.pid === undefined) {\n            // The spawn itself failed, i.e. the head of the chain (GNU time, or `timeout` without\n            // it, or the command itself on Windows) or the cwd is missing. A missing judged command\n            // is reported as status 127 by the wrapper instead. Report this like a run that produced\n            // only this message.\n            spawnErrorMessage = error.message;\n            settle(undefined, undefined);\n            return;\n          }\n          pendingError = error;\n          killSubprocessGroup(subprocess, 'SIGKILL');\n        };\n        subprocess.on('error', failAfterClose);\n        subprocess.stdin.on('error', (error: NodeJS.ErrnoException) => {\n          if (error.code !== 'EPIPE') failAfterClose(error);\n        });\n        subprocess.on('exit', (code, exitSignal) => {\n          // The command is gone, so the limit timers must not fire during the grace period below. A\n          // descendant that inherited the pipes (e.g. `sleep 1000 &`) would keep them open and hold\n          // back 'close' until it ends: kill what is left of the group. A descendant that moved to\n          // its own session survives that, so stop waiting for the pipes after the grace period and\n          // keep the output read so far.\n          clearTimeout(timeout);\n          clearTimeout(killTimeout);\n          wallTimeSeconds = (performance.now() - startTimeMilliseconds) / 1000;\n          killSubprocessGroup(subprocess, 'SIGKILL');\n          closeTimeout = setTimeout(() => {\n            subprocess.stdout.destroy();\n            subprocess.stderr.destroy();\n            settle(code, exitSignal);\n          }, killGracePeriodMilliseconds);\n        });\n        subprocess.on('close', settle);\n        subprocess.stdin.end(context.stdin);\n      }\n    ).finally(() => {\n      clearTimeout(timeout);\n      clearTimeout(killTimeout);\n      liveSubprocesses.delete(subprocess);\n    });\n\n    const timeResult =\n      timeOutput === undefined ? undefined : parseTimeOutput(await readTail(timeOutput, TIME_OUTPUT_TAIL_BYTES));\n\n    return {\n      stdout: Buffer.concat(stdoutChunks).toString(),\n      stderr: spawnErrorMessage ?? Buffer.concat(stderrChunks).toString(),\n      status,\n      signal,\n      // GNU time rounds a fast run to 0.00; the wall time until 'exit' stands in for it (never the\n      // grace period spent on the pipes afterwards).\n      timeSeconds: timeResult?.timeSeconds || wallTimeSeconds,\n      cpuTimeSeconds: timeResult?.cpuTimeSeconds ?? 0,\n      memoryBytes: timeResult?.memoryBytes ?? 0,\n      timeCommandMessage: timeResult?.message,\n      timedOut: timedOut || endedByTimeout(status, wallTimeSeconds, context.timeLimitSeconds),\n      outputLimitExceeded,\n    };\n  } finally {\n    await timeOutput?.close();\n  }\n}\n\n/**\n * Whether `timeout` ended the run: 124 says it did so at the limit, and 137 that the run ignored its\n * SIGTERM and had to be killed after the grace period. A program can exit with either status on its\n * own, so each is trusted only once the wall time reached the moment `timeout` would have produced it.\n */\nfunction endedByTimeout(status: number | undefined, wallTimeSeconds: number, timeLimitSeconds: number): boolean {\n  if (status === TIMEOUT_EXIT_STATUS) return wallTimeSeconds >= timeLimitSeconds;\n  if (status === KILLED_AFTER_TIMEOUT_EXIT_STATUS) {\n    return wallTimeSeconds >= timeLimitSeconds + killGracePeriodMilliseconds / 1000;\n  }\n  return false;\n}\n\nfunction killSubprocessGroup(subprocess: childProcess.ChildProcess, signal: NodeJS.Signals): void {\n  if (subprocess.pid === undefined) return;\n\n  try {\n    if (process.platform === 'win32') {\n      subprocess.kill(signal);\n      return;\n    }\n    process.kill(-subprocess.pid, signal);\n  } catch (error) {\n    if (!isErrorWithCode(error, 'ESRCH') && !isErrorWithCode(error, 'EPERM')) throw error;\n  }\n}\n\n// The file is unlinked before it is returned, so nothing can reach it by path anymore.\nasync function openUnlinkedFile(prefix: string): Promise<fs.FileHandle> {\n  const directory = await fs.mkdtemp(path.join(os.tmpdir(), prefix));\n  try {\n    return await fs.open(path.join(directory, 'record'), 'wx+', 0o600);\n  } finally {\n    await fs.rm(directory, { recursive: true, force: true });\n  }\n}\n\nasync function readTail(file: fs.FileHandle, maxBytes: number): Promise<string> {\n  const { size } = await file.stat();\n  const length = Math.min(size, maxBytes);\n  const { buffer } = await file.read(Buffer.alloc(length), 0, length, size - length);\n  return buffer.toString();\n}\n\n// Empty when the command was killed before GNU time wrote its record.\nfunction parseTimeOutput(\n  content: string\n): { timeSeconds: number; cpuTimeSeconds: number; memoryBytes: number; message: string | undefined } | undefined {\n  const match = /(?:^|\\n)(\\d+(?:[.,]\\d+)?) (\\d+(?:[.,]\\d+)?) (\\d+(?:[.,]\\d+)?) (\\d+)\\s*$/.exec(content);\n  if (!match) return undefined;\n\n  return {\n    timeSeconds: parseSeconds(match[1]!),\n    cpuTimeSeconds: parseSeconds(match[2]!) + parseSeconds(match[3]!),\n    memoryBytes: Number(match[4]) * 1024,\n    message: content.slice(0, match.index).trim() || undefined,\n  };\n}\n\n// GNU time formats its seconds with the locale's decimal separator.\nfunction parseSeconds(text: string): number {\n  return Number(text.replace(',', '.'));\n}\n\nfunction isErrorWithCode(error: unknown, code: string): boolean {\n  return typeof error === 'object' && error !== null && 'code' in error && (error as { code: unknown }).code === code;\n}\n\nfunction resolveTimeCommand(): readonly [string, ...string[]] | undefined {\n  const command = os.platform() === 'darwin' ? 'gtime' : '/usr/bin/time';\n  const result = childProcess.spawnSync(command, ['--version'], { stdio: 'ignore' });\n  if (result.error || result.status !== 0) return undefined;\n\n  // Wall seconds, user CPU seconds, system CPU seconds, peak resident set size in KiB.\n  return [command, '--format', '%e %U %S %M'];\n}\n"],"mappings":"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"}
+{"version":3,"file":"spawnWithLimits.cjs","names":["childProcess","hasErrorCode","fs","path","os"],"sources":["../../src/helpers/spawnWithLimits.ts"],"sourcesContent":["import childProcess from 'node:child_process';\nimport fs from 'node:fs/promises';\nimport os from 'node:os';\nimport path from 'node:path';\nimport { hasErrorCode } from '@willbooster/shared-lib';\n\nexport interface SpawnWithLimitsResult {\n  stdout: string;\n  stderr: string;\n  status: number | undefined;\n  signal: NodeJS.Signals | undefined;\n  /** Wall time measured by GNU time, or measured here until the command exited when it produced none. */\n  timeSeconds: number;\n  /**\n   * User plus system CPU time of the command and the descendants it waited for, measured by GNU\n   * time, or 0 when it produced no measurement. A run `timeout` ended is measured too, so a caller\n   * can tell a program that used up its time limit from one that waited for the CPU.\n   */\n  cpuTimeSeconds: number;\n  /**\n   * Peak resident set size measured by GNU time, or 0 when it produced no measurement. GNU time\n   * measures its child `timeout` and the descendants it waited for, so the value is at least\n   * `timeout`'s own footprint (about 1 MiB), which only shows for the smallest native programs.\n   */\n  memoryBytes: number;\n  /** The note GNU time adds when the command exits abnormally, e.g. `Command terminated by signal 11`. */\n  timeCommandMessage: string | undefined;\n  timedOut: boolean;\n  outputLimitExceeded: boolean;\n}\n\nconst killGracePeriodMilliseconds = 1000;\nconst MIN_TIMEOUT_SECONDS = 0.001;\n// GNU `timeout` exits with 124 after ending a run at its limit, or with 128 + SIGKILL when the run\n// ignored its SIGTERM and it had to be killed after the grace period.\nconst TIMEOUT_EXIT_STATUS = 124;\nconst KILLED_AFTER_TIMEOUT_EXIT_STATUS = 137;\n// GNU time writes its record to a file this process opened and unlinked at once, handed down as fd 3\n// of the command and reopened by GNU time through `/dev/fd`: the command runs as the same OS user,\n// so a record reachable by path could be swapped for a fake or for a FIFO that blocks the read.\nconst TIME_OUTPUT_FD = 3;\n// The command inherits that descriptor too, so only the tail that can hold GNU time's record is read.\nconst TIME_OUTPUT_TAIL_BYTES = 4096;\nconst timeCommand = resolveTimeCommand();\n\n/** Whether GNU time is available, i.e. whether `timeSeconds`, `cpuTimeSeconds`, and `memoryBytes` are measured at all. */\nexport const isTimeCommandAvailable = timeCommand !== undefined;\n\n// The commands run in their own sessions, so they outlive this process unless it ends them itself\n// on the way out (e.g. a preset's SIGINT handler calling `process.exit`).\nconst liveSubprocesses = new Set<childProcess.ChildProcess>();\nprocess.once('exit', () => {\n  for (const subprocess of liveSubprocesses) killSubprocessGroup(subprocess, 'SIGKILL');\n});\n\n/**\n * Runs a command in its own process group with `stdin` piped in, killing the whole group once it\n * exceeds the time or output limit, and reports the wall time, CPU time, and peak memory measured\n * by GNU time.\n */\nexport async function spawnWithLimits(\n  command: readonly [string, ...string[]],\n  context: {\n    cwd: string;\n    env: NodeJS.ProcessEnv;\n    outputLimitBytes: number;\n    stdin: string;\n    timeLimitSeconds: number;\n  }\n): Promise<SpawnWithLimitsResult> {\n  const timeOutput = timeCommand === undefined ? undefined : await openUnlinkedFile('exercode-time-');\n  try {\n    const detached = process.platform !== 'win32';\n    // The command runs in its own session so the group kill below cannot hit this process, but that\n    // also puts it out of reach of whoever kills this process. GNU `timeout` keeps the run bounded\n    // in that case, and it is what normally ends a run at its limit: GNU time wraps it, so a run\n    // that hit the limit still gets its CPU time recorded (a group kill from here would take GNU\n    // time down with the command), and `--foreground` keeps the command in this group so the kill\n    // below still reaches every descendant. The timers below only back `timeout` up. Should this\n    // process die first, `timeout` ends the command alone (`--foreground` signals no descendant),\n    // an accepted gap: the judge server sweeps every process of the request's sandbox user anyway.\n    const boundedCommand: readonly [string, ...string[]] = detached\n      ? [\n          'timeout',\n          '--foreground',\n          '-k',\n          String(killGracePeriodMilliseconds / 1000),\n          // A zero duration would disable `timeout`; the front matter allows a zero time limit.\n          String(Math.max(context.timeLimitSeconds, MIN_TIMEOUT_SECONDS)),\n          ...command,\n        ]\n      : command;\n    const spawnedCommand: readonly [string, ...string[]] =\n      timeCommand === undefined\n        ? boundedCommand\n        : [...timeCommand, `--output=/dev/fd/${TIME_OUTPUT_FD}`, ...boundedCommand];\n    // `timeout` sends SIGKILL a grace period after its SIGTERM; the timers here fire once even that\n    // should have ended the run.\n    const timeLimitMilliseconds = detached\n      ? context.timeLimitSeconds * 1000 + 2 * killGracePeriodMilliseconds\n      : context.timeLimitSeconds * 1000;\n    // Monotonic: a wall-clock step must not turn a run `timeout` ended into one that finished in time.\n    const startTimeMilliseconds = performance.now();\n    // The standard streams are always pipes; the type cannot express that with the extra entry.\n    const subprocess = childProcess.spawn(spawnedCommand[0], spawnedCommand.slice(1), {\n      cwd: context.cwd,\n      detached,\n      env: context.env,\n      stdio: timeOutput === undefined ? ['pipe', 'pipe', 'pipe'] : ['pipe', 'pipe', 'pipe', timeOutput.fd],\n    }) as childProcess.ChildProcessWithoutNullStreams;\n    liveSubprocesses.add(subprocess);\n\n    const stdoutChunks: Buffer[] = [];\n    const stderrChunks: Buffer[] = [];\n    let outputBytes = 0;\n    let timedOut = false;\n    let outputLimitExceeded = false;\n    let wallTimeSeconds = 0;\n    let spawnErrorMessage: string | undefined;\n\n    const appendOutputChunk = (chunks: Buffer[], chunk: Buffer): void => {\n      if (outputBytes >= context.outputLimitBytes) {\n        if (chunk.byteLength > 0) {\n          outputLimitExceeded = true;\n          killSubprocessGroup(subprocess, 'SIGKILL');\n        }\n        return;\n      }\n\n      const remainingBytes = context.outputLimitBytes - outputBytes;\n      const appendedChunk = chunk.byteLength > remainingBytes ? chunk.subarray(0, remainingBytes) : chunk;\n      chunks.push(appendedChunk);\n      outputBytes += appendedChunk.byteLength;\n\n      if (chunk.byteLength > remainingBytes) {\n        outputLimitExceeded = true;\n        killSubprocessGroup(subprocess, 'SIGKILL');\n      }\n    };\n\n    subprocess.stdout.on('data', (chunk: Buffer) => appendOutputChunk(stdoutChunks, chunk));\n    subprocess.stderr.on('data', (chunk: Buffer) => appendOutputChunk(stderrChunks, chunk));\n\n    const timeout = setTimeout(() => {\n      timedOut = true;\n      killSubprocessGroup(subprocess, 'SIGTERM');\n    }, timeLimitMilliseconds);\n    const killTimeout = setTimeout(() => {\n      if (timedOut) killSubprocessGroup(subprocess, 'SIGKILL');\n    }, timeLimitMilliseconds + killGracePeriodMilliseconds);\n    killTimeout.unref();\n\n    const { status, signal } = await new Promise<{ status: number | undefined; signal: NodeJS.Signals | undefined }>(\n      (resolve, reject) => {\n        let settled = false;\n        let pendingError: Error | undefined;\n        let closeTimeout: NodeJS.Timeout | undefined;\n        const settle = (code: number | null | undefined, exitSignal: NodeJS.Signals | null | undefined): void => {\n          if (settled) return;\n          settled = true;\n          clearTimeout(closeTimeout);\n          if (pendingError) {\n            reject(pendingError);\n            return;\n          }\n          resolve({ status: code ?? undefined, signal: exitSignal ?? undefined });\n        };\n        const failAfterClose = (error: Error): void => {\n          if (settled) return;\n          if (subprocess.pid === undefined) {\n            // The spawn itself failed, i.e. the head of the chain (GNU time, or `timeout` without\n            // it, or the command itself on Windows) or the cwd is missing. A missing judged command\n            // is reported as status 127 by the wrapper instead. Report this like a run that produced\n            // only this message.\n            spawnErrorMessage = error.message;\n            settle(undefined, undefined);\n            return;\n          }\n          pendingError = error;\n          killSubprocessGroup(subprocess, 'SIGKILL');\n        };\n        subprocess.on('error', failAfterClose);\n        subprocess.stdin.on('error', (error: NodeJS.ErrnoException) => {\n          if (error.code !== 'EPIPE') failAfterClose(error);\n        });\n        subprocess.on('exit', (code, exitSignal) => {\n          // The command is gone, so the limit timers must not fire during the grace period below. A\n          // descendant that inherited the pipes (e.g. `sleep 1000 &`) would keep them open and hold\n          // back 'close' until it ends: kill what is left of the group. A descendant that moved to\n          // its own session survives that, so stop waiting for the pipes after the grace period and\n          // keep the output read so far.\n          clearTimeout(timeout);\n          clearTimeout(killTimeout);\n          wallTimeSeconds = (performance.now() - startTimeMilliseconds) / 1000;\n          killSubprocessGroup(subprocess, 'SIGKILL');\n          closeTimeout = setTimeout(() => {\n            subprocess.stdout.destroy();\n            subprocess.stderr.destroy();\n            settle(code, exitSignal);\n          }, killGracePeriodMilliseconds);\n        });\n        subprocess.on('close', settle);\n        subprocess.stdin.end(context.stdin);\n      }\n    ).finally(() => {\n      clearTimeout(timeout);\n      clearTimeout(killTimeout);\n      liveSubprocesses.delete(subprocess);\n    });\n\n    const timeResult =\n      timeOutput === undefined ? undefined : parseTimeOutput(await readTail(timeOutput, TIME_OUTPUT_TAIL_BYTES));\n\n    return {\n      stdout: Buffer.concat(stdoutChunks).toString(),\n      stderr: spawnErrorMessage ?? Buffer.concat(stderrChunks).toString(),\n      status,\n      signal,\n      // GNU time rounds a fast run to 0.00; the wall time until 'exit' stands in for it (never the\n      // grace period spent on the pipes afterwards).\n      timeSeconds: timeResult?.timeSeconds || wallTimeSeconds,\n      cpuTimeSeconds: timeResult?.cpuTimeSeconds ?? 0,\n      memoryBytes: timeResult?.memoryBytes ?? 0,\n      timeCommandMessage: timeResult?.message,\n      timedOut: timedOut || endedByTimeout(status, wallTimeSeconds, context.timeLimitSeconds),\n      outputLimitExceeded,\n    };\n  } finally {\n    await timeOutput?.close();\n  }\n}\n\n/**\n * Whether `timeout` ended the run: 124 says it did so at the limit, and 137 that the run ignored its\n * SIGTERM and had to be killed after the grace period. A program can exit with either status on its\n * own, so each is trusted only once the wall time reached the moment `timeout` would have produced it.\n */\nfunction endedByTimeout(status: number | undefined, wallTimeSeconds: number, timeLimitSeconds: number): boolean {\n  if (status === TIMEOUT_EXIT_STATUS) return wallTimeSeconds >= timeLimitSeconds;\n  if (status === KILLED_AFTER_TIMEOUT_EXIT_STATUS) {\n    return wallTimeSeconds >= timeLimitSeconds + killGracePeriodMilliseconds / 1000;\n  }\n  return false;\n}\n\nfunction killSubprocessGroup(subprocess: childProcess.ChildProcess, signal: NodeJS.Signals): void {\n  if (subprocess.pid === undefined) return;\n\n  try {\n    if (process.platform === 'win32') {\n      subprocess.kill(signal);\n      return;\n    }\n    process.kill(-subprocess.pid, signal);\n  } catch (error) {\n    if (!hasErrorCode(error, 'ESRCH') && !hasErrorCode(error, 'EPERM')) throw error;\n  }\n}\n\n// The file is unlinked before it is returned, so nothing can reach it by path anymore.\nasync function openUnlinkedFile(prefix: string): Promise<fs.FileHandle> {\n  const directory = await fs.mkdtemp(path.join(os.tmpdir(), prefix));\n  try {\n    return await fs.open(path.join(directory, 'record'), 'wx+', 0o600);\n  } finally {\n    await fs.rm(directory, { recursive: true, force: true });\n  }\n}\n\nasync function readTail(file: fs.FileHandle, maxBytes: number): Promise<string> {\n  const { size } = await file.stat();\n  const length = Math.min(size, maxBytes);\n  const { buffer } = await file.read(Buffer.alloc(length), 0, length, size - length);\n  return buffer.toString();\n}\n\n// Empty when the command was killed before GNU time wrote its record.\nfunction parseTimeOutput(\n  content: string\n): { timeSeconds: number; cpuTimeSeconds: number; memoryBytes: number; message: string | undefined } | undefined {\n  const match = /(?:^|\\n)(\\d+(?:[.,]\\d+)?) (\\d+(?:[.,]\\d+)?) (\\d+(?:[.,]\\d+)?) (\\d+)\\s*$/.exec(content);\n  if (!match) return undefined;\n\n  return {\n    timeSeconds: parseSeconds(match[1]!),\n    cpuTimeSeconds: parseSeconds(match[2]!) + parseSeconds(match[3]!),\n    memoryBytes: Number(match[4]) * 1024,\n    message: content.slice(0, match.index).trim() || undefined,\n  };\n}\n\n// GNU time formats its seconds with the locale's decimal separator.\nfunction parseSeconds(text: string): number {\n  return Number(text.replace(',', '.'));\n}\n\nfunction resolveTimeCommand(): readonly [string, ...string[]] | undefined {\n  const command = os.platform() === 'darwin' ? 'gtime' : '/usr/bin/time';\n  const result = childProcess.spawnSync(command, ['--version'], { stdio: 'ignore' });\n  if (result.error || result.status !== 0) return undefined;\n\n  // Wall seconds, user CPU seconds, system CPU seconds, peak resident set size in KiB.\n  return [command, '--format', '%e %U %S %M'];\n}\n"],"mappings":"qSA+BA,MAAM,EAA8B,IAY9B,EAAc,EAAmB,EAG1B,EAAyB,IAAgB,IAAA,GAIhD,kBAAmB,IAAI,IAC7B,QAAQ,KAAK,WAAc,CACzB,IAAK,IAAM,KAAc,EAAkB,EAAoB,EAAY,SAAS,CACtF,CAAC,EAOD,eAAsB,EACpB,EACA,EAOgC,CAChC,IAAM,EAAa,IAAgB,IAAA,GAAY,IAAA,GAAY,MAAM,EAAiB,gBAAgB,EAClG,GAAI,CACF,IAAM,EAAW,QAAQ,WAAa,QAShC,EAAiD,EACnD,CACE,UACA,eACA,KACA,IAEA,OAAO,KAAK,IAAI,EAAQ,iBAAkB,IAAmB,CAAC,EAC9D,GAAG,CACL,EACA,EACE,EACJ,IAAgB,IAAA,GACZ,EACA,CAAC,GAAG,EAAa,qBAAsC,GAAG,CAAc,EAGxE,EAAwB,EAC1B,EAAQ,iBAAmB,IAAO,EAAI,EACtC,EAAQ,iBAAmB,IAEzB,EAAwB,YAAY,IAAI,EAExC,EAAaA,EAAAA,QAAa,MAAM,EAAe,GAAI,EAAe,MAAM,CAAC,EAAG,CAChF,IAAK,EAAQ,IACb,WACA,IAAK,EAAQ,IACb,MAAO,IAAe,IAAA,GAAY,CAAC,OAAQ,OAAQ,MAAM,EAAI,CAAC,OAAQ,OAAQ,OAAQ,EAAW,EAAE,CACrG,CAAC,EACD,EAAiB,IAAI,CAAU,EAE/B,IAAM,EAAyB,CAAC,EAC1B,EAAyB,CAAC,EAC5B,EAAc,EACd,EAAW,GACX,EAAsB,GACtB,EAAkB,EAClB,EAEE,GAAqB,EAAkB,IAAwB,CACnE,GAAI,GAAe,EAAQ,iBAAkB,CACvC,EAAM,WAAa,IACrB,EAAsB,GACtB,EAAoB,EAAY,SAAS,GAE3C,MACF,CAEA,IAAM,EAAiB,EAAQ,iBAAmB,EAC5C,EAAgB,EAAM,WAAa,EAAiB,EAAM,SAAS,EAAG,CAAc,EAAI,EAC9F,EAAO,KAAK,CAAa,EACzB,GAAe,EAAc,WAEzB,EAAM,WAAa,IACrB,EAAsB,GACtB,EAAoB,EAAY,SAAS,EAE7C,EAEA,EAAW,OAAO,GAAG,OAAS,GAAkB,EAAkB,EAAc,CAAK,CAAC,EACtF,EAAW,OAAO,GAAG,OAAS,GAAkB,EAAkB,EAAc,CAAK,CAAC,EAEtF,IAAM,EAAU,eAAiB,CAC/B,EAAW,GACX,EAAoB,EAAY,SAAS,CAC3C,EAAG,CAAqB,EAClB,EAAc,eAAiB,CAC/B,GAAU,EAAoB,EAAY,SAAS,CACzD,EAAG,EAAwB,CAA2B,EACtD,EAAY,MAAM,EAElB,GAAM,CAAE,SAAQ,UAAW,MAAM,IAAI,SAClC,EAAS,IAAW,CACnB,IAAI,EAAU,GACV,EACA,EACE,GAAU,EAAiC,IAAwD,CACnG,MAGJ,IAFA,EAAU,GACV,aAAa,CAAY,EACrB,EAAc,CAChB,EAAO,CAAY,EACnB,MACF,CACA,EAAQ,CAAE,OAAQ,GAAQ,IAAA,GAAW,OAAQ,GAAc,IAAA,EAAU,CAAC,CADtE,CAEF,EACM,EAAkB,GAAuB,CACzC,MACJ,IAAI,EAAW,MAAQ,IAAA,GAAW,CAKhC,EAAoB,EAAM,QAC1B,EAAO,IAAA,GAAW,IAAA,EAAS,EAC3B,MACF,CACA,EAAe,EACf,EAAoB,EAAY,SAAS,CAFzC,CAGF,EACA,EAAW,GAAG,QAAS,CAAc,EACrC,EAAW,MAAM,GAAG,QAAU,GAAiC,CACzD,EAAM,OAAS,SAAS,EAAe,CAAK,CAClD,CAAC,EACD,EAAW,GAAG,QAAS,EAAM,IAAe,CAM1C,aAAa,CAAO,EACpB,aAAa,CAAW,EACxB,GAAmB,YAAY,IAAI,EAAI,GAAyB,IAChE,EAAoB,EAAY,SAAS,EACzC,EAAe,eAAiB,CAC9B,EAAW,OAAO,QAAQ,EAC1B,EAAW,OAAO,QAAQ,EAC1B,EAAO,EAAM,CAAU,CACzB,EAAG,CAA2B,CAChC,CAAC,EACD,EAAW,GAAG,QAAS,CAAM,EAC7B,EAAW,MAAM,IAAI,EAAQ,KAAK,CACpC,CACF,CAAC,CAAC,YAAc,CACd,aAAa,CAAO,EACpB,aAAa,CAAW,EACxB,EAAiB,OAAO,CAAU,CACpC,CAAC,EAEK,EACJ,IAAe,IAAA,GAAY,IAAA,GAAY,EAAgB,MAAM,EAAS,EAAY,IAAsB,CAAC,EAE3G,MAAO,CACL,OAAQ,OAAO,OAAO,CAAY,CAAC,CAAC,SAAS,EAC7C,OAAQ,GAAqB,OAAO,OAAO,CAAY,CAAC,CAAC,SAAS,EAClE,SACA,SAGA,YAAa,GAAY,aAAe,EACxC,eAAgB,GAAY,gBAAkB,EAC9C,YAAa,GAAY,aAAe,EACxC,mBAAoB,GAAY,QAChC,SAAU,GAAY,EAAe,EAAQ,EAAiB,EAAQ,gBAAgB,EACtF,qBACF,CACF,QAAU,CACR,MAAM,GAAY,MAAM,CAC1B,CACF,CAOA,SAAS,EAAe,EAA4B,EAAyB,EAAmC,CAK9G,OAJI,IAAW,IAA4B,GAAmB,EAC1D,IAAW,KACN,GAAmB,EAAmB,EAA8B,GAG/E,CAEA,SAAS,EAAoB,EAAuC,EAA8B,CAC5F,KAAW,MAAQ,IAAA,GAEvB,GAAI,CACF,GAAI,QAAQ,WAAa,QAAS,CAChC,EAAW,KAAK,CAAM,EACtB,MACF,CACA,QAAQ,KAAK,CAAC,EAAW,IAAK,CAAM,CACtC,OAAS,EAAO,CACd,GAAI,EAAA,EAACC,EAAAA,aAAAA,CAAa,EAAO,OAAO,GAAK,EAAA,EAACA,EAAAA,aAAAA,CAAa,EAAO,OAAO,EAAG,MAAM,CAC5E,CACF,CAGA,eAAe,EAAiB,EAAwC,CACtE,IAAM,EAAY,MAAMC,EAAAA,QAAG,QAAQC,EAAAA,QAAK,KAAKC,EAAAA,QAAG,OAAO,EAAG,CAAM,CAAC,EACjE,GAAI,CACF,OAAO,MAAMF,EAAAA,QAAG,KAAKC,EAAAA,QAAK,KAAK,EAAW,QAAQ,EAAG,MAAO,GAAK,CACnE,QAAU,CACR,MAAMD,EAAAA,QAAG,GAAG,EAAW,CAAE,UAAW,GAAM,MAAO,EAAK,CAAC,CACzD,CACF,CAEA,eAAe,EAAS,EAAqB,EAAmC,CAC9E,GAAM,CAAE,QAAS,MAAM,EAAK,KAAK,EAC3B,EAAS,KAAK,IAAI,EAAM,CAAQ,EAChC,CAAE,UAAW,MAAM,EAAK,KAAK,OAAO,MAAM,CAAM,EAAG,EAAG,EAAQ,EAAO,CAAM,EACjF,OAAO,EAAO,SAAS,CACzB,CAGA,SAAS,EACP,EAC+G,CAC/G,IAAM,EAAQ,0EAA0E,KAAK,CAAO,EAC/F,KAEL,MAAO,CACL,YAAa,EAAa,EAAM,EAAG,EACnC,eAAgB,EAAa,EAAM,EAAG,EAAI,EAAa,EAAM,EAAG,EAChE,YAAa,OAAO,EAAM,EAAE,EAAI,KAChC,QAAS,EAAQ,MAAM,EAAG,EAAM,KAAK,CAAC,CAAC,KAAK,GAAK,IAAA,EACnD,CACF,CAGA,SAAS,EAAa,EAAsB,CAC1C,OAAO,OAAO,EAAK,QAAQ,IAAK,GAAG,CAAC,CACtC,CAEA,SAAS,GAAiE,CACxE,IAAM,EAAUE,EAAAA,QAAG,SAAS,IAAM,SAAW,QAAU,gBACjD,EAASJ,EAAAA,QAAa,UAAU,EAAS,CAAC,WAAW,EAAG,CAAE,MAAO,QAAS,CAAC,EAC7E,OAAO,OAAS,EAAO,SAAW,GAGtC,MAAO,CAAC,EAAS,WAAY,aAAa,CAC5C"}

package/dist/helpers/spawnWithLimits.js

@@ -1,2 +1,2 @@
-import e from"node:path";import t from"node:fs/promises";import n from"node:os";import r from"node:child_process";const i=1e3,a=g(),o=a!==void 0,s=new Set;process.once(`exit`,()=>{for(let e of s)u(e,`SIGKILL`)});async function c(e,t){let n=a===void 0?void 0:await d(`exercode-time-`);try{let o=process.platform!==`win32`,c=o?[`timeout`,`--foreground`,`-k`,`1`,String(Math.max(t.timeLimitSeconds,.001)),...e]:e,d=a===void 0?c:[...a,`--output=/dev/fd/3`,...c],m=o?t.timeLimitSeconds*1e3+2*i:t.timeLimitSeconds*1e3,h=performance.now(),g=r.spawn(d[0],d.slice(1),{cwd:t.cwd,detached:o,env:t.env,stdio:n===void 0?[`pipe`,`pipe`,`pipe`]:[`pipe`,`pipe`,`pipe`,n.fd]});s.add(g);let _=[],v=[],y=0,b=!1,x=!1,S=0,C,w=(e,n)=>{if(y>=t.outputLimitBytes){n.byteLength>0&&(x=!0,u(g,`SIGKILL`));return}let r=t.outputLimitBytes-y,i=n.byteLength>r?n.subarray(0,r):n;e.push(i),y+=i.byteLength,n.byteLength>r&&(x=!0,u(g,`SIGKILL`))};g.stdout.on(`data`,e=>w(_,e)),g.stderr.on(`data`,e=>w(v,e));let T=setTimeout(()=>{b=!0,u(g,`SIGTERM`)},m),E=setTimeout(()=>{b&&u(g,`SIGKILL`)},m+i);E.unref();let{status:D,signal:O}=await new Promise((e,n)=>{let r=!1,a,o,s=(t,i)=>{if(!r){if(r=!0,clearTimeout(o),a){n(a);return}e({status:t??void 0,signal:i??void 0})}},c=e=>{if(!r){if(g.pid===void 0){C=e.message,s(void 0,void 0);return}a=e,u(g,`SIGKILL`)}};g.on(`error`,c),g.stdin.on(`error`,e=>{e.code!==`EPIPE`&&c(e)}),g.on(`exit`,(e,t)=>{clearTimeout(T),clearTimeout(E),S=(performance.now()-h)/1e3,u(g,`SIGKILL`),o=setTimeout(()=>{g.stdout.destroy(),g.stderr.destroy(),s(e,t)},i)}),g.on(`close`,s),g.stdin.end(t.stdin)}).finally(()=>{clearTimeout(T),clearTimeout(E),s.delete(g)}),k=n===void 0?void 0:p(await f(n,4096));return{stdout:Buffer.concat(_).toString(),stderr:C??Buffer.concat(v).toString(),status:D,signal:O,timeSeconds:k?.timeSeconds||S,cpuTimeSeconds:k?.cpuTimeSeconds??0,memoryBytes:k?.memoryBytes??0,timeCommandMessage:k?.message,timedOut:b||l(D,S,t.timeLimitSeconds),outputLimitExceeded:x}}finally{await n?.close()}}function l(e,t,n){return e===124?t>=n:e===137&&t>=n+i/1e3}function u(e,t){if(e.pid!==void 0)try{if(process.platform===`win32`){e.kill(t);return}process.kill(-e.pid,t)}catch(e){if(!h(e,`ESRCH`)&&!h(e,`EPERM`))throw e}}async function d(r){let i=await t.mkdtemp(e.join(n.tmpdir(),r));try{return await t.open(e.join(i,`record`),`wx+`,384)}finally{await t.rm(i,{recursive:!0,force:!0})}}async function f(e,t){let{size:n}=await e.stat(),r=Math.min(n,t),{buffer:i}=await e.read(Buffer.alloc(r),0,r,n-r);return i.toString()}function p(e){let t=/(?:^|\n)(\d+(?:[.,]\d+)?) (\d+(?:[.,]\d+)?) (\d+(?:[.,]\d+)?) (\d+)\s*$/.exec(e);if(t)return{timeSeconds:m(t[1]),cpuTimeSeconds:m(t[2])+m(t[3]),memoryBytes:Number(t[4])*1024,message:e.slice(0,t.index).trim()||void 0}}function m(e){return Number(e.replace(`,`,`.`))}function h(e,t){return typeof e==`object`&&!!e&&`code`in e&&e.code===t}function g(){let e=n.platform()===`darwin`?`gtime`:`/usr/bin/time`,t=r.spawnSync(e,[`--version`],{stdio:`ignore`});if(!(t.error||t.status!==0))return[e,`--format`,`%e %U %S %M`]}export{o as isTimeCommandAvailable,c as spawnWithLimits};
+import e from"node:path";import t from"node:fs/promises";import n from"node:os";import{hasErrorCode as r}from"@willbooster/shared-lib";import i from"node:child_process";const a=1e3,o=g(),s=o!==void 0,c=/* @__PURE__ */ new Set;process.once(`exit`,()=>{for(let e of c)d(e,`SIGKILL`)});async function l(e,t){let n=o===void 0?void 0:await f(`exercode-time-`);try{let r=process.platform!==`win32`,s=r?[`timeout`,`--foreground`,`-k`,`1`,String(Math.max(t.timeLimitSeconds,.001)),...e]:e,l=o===void 0?s:[...o,`--output=/dev/fd/3`,...s],f=r?t.timeLimitSeconds*1e3+2*a:t.timeLimitSeconds*1e3,h=performance.now(),g=i.spawn(l[0],l.slice(1),{cwd:t.cwd,detached:r,env:t.env,stdio:n===void 0?[`pipe`,`pipe`,`pipe`]:[`pipe`,`pipe`,`pipe`,n.fd]});c.add(g);let _=[],v=[],y=0,b=!1,x=!1,S=0,C,w=(e,n)=>{if(y>=t.outputLimitBytes){n.byteLength>0&&(x=!0,d(g,`SIGKILL`));return}let r=t.outputLimitBytes-y,i=n.byteLength>r?n.subarray(0,r):n;e.push(i),y+=i.byteLength,n.byteLength>r&&(x=!0,d(g,`SIGKILL`))};g.stdout.on(`data`,e=>w(_,e)),g.stderr.on(`data`,e=>w(v,e));let T=setTimeout(()=>{b=!0,d(g,`SIGTERM`)},f),E=setTimeout(()=>{b&&d(g,`SIGKILL`)},f+a);E.unref();let{status:D,signal:O}=await new Promise((e,n)=>{let r=!1,i,o,s=(t,a)=>{if(!r){if(r=!0,clearTimeout(o),i){n(i);return}e({status:t??void 0,signal:a??void 0})}},c=e=>{if(!r){if(g.pid===void 0){C=e.message,s(void 0,void 0);return}i=e,d(g,`SIGKILL`)}};g.on(`error`,c),g.stdin.on(`error`,e=>{e.code!==`EPIPE`&&c(e)}),g.on(`exit`,(e,t)=>{clearTimeout(T),clearTimeout(E),S=(performance.now()-h)/1e3,d(g,`SIGKILL`),o=setTimeout(()=>{g.stdout.destroy(),g.stderr.destroy(),s(e,t)},a)}),g.on(`close`,s),g.stdin.end(t.stdin)}).finally(()=>{clearTimeout(T),clearTimeout(E),c.delete(g)}),k=n===void 0?void 0:m(await p(n,4096));return{stdout:Buffer.concat(_).toString(),stderr:C??Buffer.concat(v).toString(),status:D,signal:O,timeSeconds:k?.timeSeconds||S,cpuTimeSeconds:k?.cpuTimeSeconds??0,memoryBytes:k?.memoryBytes??0,timeCommandMessage:k?.message,timedOut:b||u(D,S,t.timeLimitSeconds),outputLimitExceeded:x}}finally{await n?.close()}}function u(e,t,n){return e===124?t>=n:e===137&&t>=n+a/1e3}function d(e,t){if(e.pid!==void 0)try{if(process.platform===`win32`){e.kill(t);return}process.kill(-e.pid,t)}catch(e){if(!r(e,`ESRCH`)&&!r(e,`EPERM`))throw e}}async function f(r){let i=await t.mkdtemp(e.join(n.tmpdir(),r));try{return await t.open(e.join(i,`record`),`wx+`,384)}finally{await t.rm(i,{recursive:!0,force:!0})}}async function p(e,t){let{size:n}=await e.stat(),r=Math.min(n,t),{buffer:i}=await e.read(Buffer.alloc(r),0,r,n-r);return i.toString()}function m(e){let t=/(?:^|\n)(\d+(?:[.,]\d+)?) (\d+(?:[.,]\d+)?) (\d+(?:[.,]\d+)?) (\d+)\s*$/.exec(e);if(t)return{timeSeconds:h(t[1]),cpuTimeSeconds:h(t[2])+h(t[3]),memoryBytes:Number(t[4])*1024,message:e.slice(0,t.index).trim()||void 0}}function h(e){return Number(e.replace(`,`,`.`))}function g(){let e=n.platform()===`darwin`?`gtime`:`/usr/bin/time`,t=i.spawnSync(e,[`--version`],{stdio:`ignore`});if(!(t.error||t.status!==0))return[e,`--format`,`%e %U %S %M`]}export{s as isTimeCommandAvailable,l as spawnWithLimits};
 //# sourceMappingURL=spawnWithLimits.js.map

package/dist/helpers/spawnWithLimits.js.map

@@ -1 +1 @@
-{"version":3,"file":"spawnWithLimits.js","names":[],"sources":["../../src/helpers/spawnWithLimits.ts"],"sourcesContent":["import childProcess from 'node:child_process';\nimport fs from 'node:fs/promises';\nimport os from 'node:os';\nimport path from 'node:path';\n\nexport interface SpawnWithLimitsResult {\n  stdout: string;\n  stderr: string;\n  status: number | undefined;\n  signal: NodeJS.Signals | undefined;\n  /** Wall time measured by GNU time, or measured here until the command exited when it produced none. */\n  timeSeconds: number;\n  /**\n   * User plus system CPU time of the command and the descendants it waited for, measured by GNU\n   * time, or 0 when it produced no measurement. A run `timeout` ended is measured too, so a caller\n   * can tell a program that used up its time limit from one that waited for the CPU.\n   */\n  cpuTimeSeconds: number;\n  /**\n   * Peak resident set size measured by GNU time, or 0 when it produced no measurement. GNU time\n   * measures its child `timeout` and the descendants it waited for, so the value is at least\n   * `timeout`'s own footprint (about 1 MiB), which only shows for the smallest native programs.\n   */\n  memoryBytes: number;\n  /** The note GNU time adds when the command exits abnormally, e.g. `Command terminated by signal 11`. */\n  timeCommandMessage: string | undefined;\n  timedOut: boolean;\n  outputLimitExceeded: boolean;\n}\n\nconst killGracePeriodMilliseconds = 1000;\nconst MIN_TIMEOUT_SECONDS = 0.001;\n// GNU `timeout` exits with 124 after ending a run at its limit, or with 128 + SIGKILL when the run\n// ignored its SIGTERM and it had to be killed after the grace period.\nconst TIMEOUT_EXIT_STATUS = 124;\nconst KILLED_AFTER_TIMEOUT_EXIT_STATUS = 137;\n// GNU time writes its record to a file this process opened and unlinked at once, handed down as fd 3\n// of the command and reopened by GNU time through `/dev/fd`: the command runs as the same OS user,\n// so a record reachable by path could be swapped for a fake or for a FIFO that blocks the read.\nconst TIME_OUTPUT_FD = 3;\n// The command inherits that descriptor too, so only the tail that can hold GNU time's record is read.\nconst TIME_OUTPUT_TAIL_BYTES = 4096;\nconst timeCommand = resolveTimeCommand();\n\n/** Whether GNU time is available, i.e. whether `timeSeconds`, `cpuTimeSeconds`, and `memoryBytes` are measured at all. */\nexport const isTimeCommandAvailable = timeCommand !== undefined;\n\n// The commands run in their own sessions, so they outlive this process unless it ends them itself\n// on the way out (e.g. a preset's SIGINT handler calling `process.exit`).\nconst liveSubprocesses = new Set<childProcess.ChildProcess>();\nprocess.once('exit', () => {\n  for (const subprocess of liveSubprocesses) killSubprocessGroup(subprocess, 'SIGKILL');\n});\n\n/**\n * Runs a command in its own process group with `stdin` piped in, killing the whole group once it\n * exceeds the time or output limit, and reports the wall time, CPU time, and peak memory measured\n * by GNU time.\n */\nexport async function spawnWithLimits(\n  command: readonly [string, ...string[]],\n  context: {\n    cwd: string;\n    env: NodeJS.ProcessEnv;\n    outputLimitBytes: number;\n    stdin: string;\n    timeLimitSeconds: number;\n  }\n): Promise<SpawnWithLimitsResult> {\n  const timeOutput = timeCommand === undefined ? undefined : await openUnlinkedFile('exercode-time-');\n  try {\n    const detached = process.platform !== 'win32';\n    // The command runs in its own session so the group kill below cannot hit this process, but that\n    // also puts it out of reach of whoever kills this process. GNU `timeout` keeps the run bounded\n    // in that case, and it is what normally ends a run at its limit: GNU time wraps it, so a run\n    // that hit the limit still gets its CPU time recorded (a group kill from here would take GNU\n    // time down with the command), and `--foreground` keeps the command in this group so the kill\n    // below still reaches every descendant. The timers below only back `timeout` up. Should this\n    // process die first, `timeout` ends the command alone (`--foreground` signals no descendant),\n    // an accepted gap: the judge server sweeps every process of the request's sandbox user anyway.\n    const boundedCommand: readonly [string, ...string[]] = detached\n      ? [\n          'timeout',\n          '--foreground',\n          '-k',\n          String(killGracePeriodMilliseconds / 1000),\n          // A zero duration would disable `timeout`; the front matter allows a zero time limit.\n          String(Math.max(context.timeLimitSeconds, MIN_TIMEOUT_SECONDS)),\n          ...command,\n        ]\n      : command;\n    const spawnedCommand: readonly [string, ...string[]] =\n      timeCommand === undefined\n        ? boundedCommand\n        : [...timeCommand, `--output=/dev/fd/${TIME_OUTPUT_FD}`, ...boundedCommand];\n    // `timeout` sends SIGKILL a grace period after its SIGTERM; the timers here fire once even that\n    // should have ended the run.\n    const timeLimitMilliseconds = detached\n      ? context.timeLimitSeconds * 1000 + 2 * killGracePeriodMilliseconds\n      : context.timeLimitSeconds * 1000;\n    // Monotonic: a wall-clock step must not turn a run `timeout` ended into one that finished in time.\n    const startTimeMilliseconds = performance.now();\n    // The standard streams are always pipes; the type cannot express that with the extra entry.\n    const subprocess = childProcess.spawn(spawnedCommand[0], spawnedCommand.slice(1), {\n      cwd: context.cwd,\n      detached,\n      env: context.env,\n      stdio: timeOutput === undefined ? ['pipe', 'pipe', 'pipe'] : ['pipe', 'pipe', 'pipe', timeOutput.fd],\n    }) as childProcess.ChildProcessWithoutNullStreams;\n    liveSubprocesses.add(subprocess);\n\n    const stdoutChunks: Buffer[] = [];\n    const stderrChunks: Buffer[] = [];\n    let outputBytes = 0;\n    let timedOut = false;\n    let outputLimitExceeded = false;\n    let wallTimeSeconds = 0;\n    let spawnErrorMessage: string | undefined;\n\n    const appendOutputChunk = (chunks: Buffer[], chunk: Buffer): void => {\n      if (outputBytes >= context.outputLimitBytes) {\n        if (chunk.byteLength > 0) {\n          outputLimitExceeded = true;\n          killSubprocessGroup(subprocess, 'SIGKILL');\n        }\n        return;\n      }\n\n      const remainingBytes = context.outputLimitBytes - outputBytes;\n      const appendedChunk = chunk.byteLength > remainingBytes ? chunk.subarray(0, remainingBytes) : chunk;\n      chunks.push(appendedChunk);\n      outputBytes += appendedChunk.byteLength;\n\n      if (chunk.byteLength > remainingBytes) {\n        outputLimitExceeded = true;\n        killSubprocessGroup(subprocess, 'SIGKILL');\n      }\n    };\n\n    subprocess.stdout.on('data', (chunk: Buffer) => appendOutputChunk(stdoutChunks, chunk));\n    subprocess.stderr.on('data', (chunk: Buffer) => appendOutputChunk(stderrChunks, chunk));\n\n    const timeout = setTimeout(() => {\n      timedOut = true;\n      killSubprocessGroup(subprocess, 'SIGTERM');\n    }, timeLimitMilliseconds);\n    const killTimeout = setTimeout(() => {\n      if (timedOut) killSubprocessGroup(subprocess, 'SIGKILL');\n    }, timeLimitMilliseconds + killGracePeriodMilliseconds);\n    killTimeout.unref();\n\n    const { status, signal } = await new Promise<{ status: number | undefined; signal: NodeJS.Signals | undefined }>(\n      (resolve, reject) => {\n        let settled = false;\n        let pendingError: Error | undefined;\n        let closeTimeout: NodeJS.Timeout | undefined;\n        const settle = (code: number | null | undefined, exitSignal: NodeJS.Signals | null | undefined): void => {\n          if (settled) return;\n          settled = true;\n          clearTimeout(closeTimeout);\n          if (pendingError) {\n            reject(pendingError);\n            return;\n          }\n          resolve({ status: code ?? undefined, signal: exitSignal ?? undefined });\n        };\n        const failAfterClose = (error: Error): void => {\n          if (settled) return;\n          if (subprocess.pid === undefined) {\n            // The spawn itself failed, i.e. the head of the chain (GNU time, or `timeout` without\n            // it, or the command itself on Windows) or the cwd is missing. A missing judged command\n            // is reported as status 127 by the wrapper instead. Report this like a run that produced\n            // only this message.\n            spawnErrorMessage = error.message;\n            settle(undefined, undefined);\n            return;\n          }\n          pendingError = error;\n          killSubprocessGroup(subprocess, 'SIGKILL');\n        };\n        subprocess.on('error', failAfterClose);\n        subprocess.stdin.on('error', (error: NodeJS.ErrnoException) => {\n          if (error.code !== 'EPIPE') failAfterClose(error);\n        });\n        subprocess.on('exit', (code, exitSignal) => {\n          // The command is gone, so the limit timers must not fire during the grace period below. A\n          // descendant that inherited the pipes (e.g. `sleep 1000 &`) would keep them open and hold\n          // back 'close' until it ends: kill what is left of the group. A descendant that moved to\n          // its own session survives that, so stop waiting for the pipes after the grace period and\n          // keep the output read so far.\n          clearTimeout(timeout);\n          clearTimeout(killTimeout);\n          wallTimeSeconds = (performance.now() - startTimeMilliseconds) / 1000;\n          killSubprocessGroup(subprocess, 'SIGKILL');\n          closeTimeout = setTimeout(() => {\n            subprocess.stdout.destroy();\n            subprocess.stderr.destroy();\n            settle(code, exitSignal);\n          }, killGracePeriodMilliseconds);\n        });\n        subprocess.on('close', settle);\n        subprocess.stdin.end(context.stdin);\n      }\n    ).finally(() => {\n      clearTimeout(timeout);\n      clearTimeout(killTimeout);\n      liveSubprocesses.delete(subprocess);\n    });\n\n    const timeResult =\n      timeOutput === undefined ? undefined : parseTimeOutput(await readTail(timeOutput, TIME_OUTPUT_TAIL_BYTES));\n\n    return {\n      stdout: Buffer.concat(stdoutChunks).toString(),\n      stderr: spawnErrorMessage ?? Buffer.concat(stderrChunks).toString(),\n      status,\n      signal,\n      // GNU time rounds a fast run to 0.00; the wall time until 'exit' stands in for it (never the\n      // grace period spent on the pipes afterwards).\n      timeSeconds: timeResult?.timeSeconds || wallTimeSeconds,\n      cpuTimeSeconds: timeResult?.cpuTimeSeconds ?? 0,\n      memoryBytes: timeResult?.memoryBytes ?? 0,\n      timeCommandMessage: timeResult?.message,\n      timedOut: timedOut || endedByTimeout(status, wallTimeSeconds, context.timeLimitSeconds),\n      outputLimitExceeded,\n    };\n  } finally {\n    await timeOutput?.close();\n  }\n}\n\n/**\n * Whether `timeout` ended the run: 124 says it did so at the limit, and 137 that the run ignored its\n * SIGTERM and had to be killed after the grace period. A program can exit with either status on its\n * own, so each is trusted only once the wall time reached the moment `timeout` would have produced it.\n */\nfunction endedByTimeout(status: number | undefined, wallTimeSeconds: number, timeLimitSeconds: number): boolean {\n  if (status === TIMEOUT_EXIT_STATUS) return wallTimeSeconds >= timeLimitSeconds;\n  if (status === KILLED_AFTER_TIMEOUT_EXIT_STATUS) {\n    return wallTimeSeconds >= timeLimitSeconds + killGracePeriodMilliseconds / 1000;\n  }\n  return false;\n}\n\nfunction killSubprocessGroup(subprocess: childProcess.ChildProcess, signal: NodeJS.Signals): void {\n  if (subprocess.pid === undefined) return;\n\n  try {\n    if (process.platform === 'win32') {\n      subprocess.kill(signal);\n      return;\n    }\n    process.kill(-subprocess.pid, signal);\n  } catch (error) {\n    if (!isErrorWithCode(error, 'ESRCH') && !isErrorWithCode(error, 'EPERM')) throw error;\n  }\n}\n\n// The file is unlinked before it is returned, so nothing can reach it by path anymore.\nasync function openUnlinkedFile(prefix: string): Promise<fs.FileHandle> {\n  const directory = await fs.mkdtemp(path.join(os.tmpdir(), prefix));\n  try {\n    return await fs.open(path.join(directory, 'record'), 'wx+', 0o600);\n  } finally {\n    await fs.rm(directory, { recursive: true, force: true });\n  }\n}\n\nasync function readTail(file: fs.FileHandle, maxBytes: number): Promise<string> {\n  const { size } = await file.stat();\n  const length = Math.min(size, maxBytes);\n  const { buffer } = await file.read(Buffer.alloc(length), 0, length, size - length);\n  return buffer.toString();\n}\n\n// Empty when the command was killed before GNU time wrote its record.\nfunction parseTimeOutput(\n  content: string\n): { timeSeconds: number; cpuTimeSeconds: number; memoryBytes: number; message: string | undefined } | undefined {\n  const match = /(?:^|\\n)(\\d+(?:[.,]\\d+)?) (\\d+(?:[.,]\\d+)?) (\\d+(?:[.,]\\d+)?) (\\d+)\\s*$/.exec(content);\n  if (!match) return undefined;\n\n  return {\n    timeSeconds: parseSeconds(match[1]!),\n    cpuTimeSeconds: parseSeconds(match[2]!) + parseSeconds(match[3]!),\n    memoryBytes: Number(match[4]) * 1024,\n    message: content.slice(0, match.index).trim() || undefined,\n  };\n}\n\n// GNU time formats its seconds with the locale's decimal separator.\nfunction parseSeconds(text: string): number {\n  return Number(text.replace(',', '.'));\n}\n\nfunction isErrorWithCode(error: unknown, code: string): boolean {\n  return typeof error === 'object' && error !== null && 'code' in error && (error as { code: unknown }).code === code;\n}\n\nfunction resolveTimeCommand(): readonly [string, ...string[]] | undefined {\n  const command = os.platform() === 'darwin' ? 'gtime' : '/usr/bin/time';\n  const result = childProcess.spawnSync(command, ['--version'], { stdio: 'ignore' });\n  if (result.error || result.status !== 0) return undefined;\n\n  // Wall seconds, user CPU seconds, system CPU seconds, peak resident set size in KiB.\n  return [command, '--format', '%e %U %S %M'];\n}\n"],"mappings":"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"}
+{"version":3,"file":"spawnWithLimits.js","names":[],"sources":["../../src/helpers/spawnWithLimits.ts"],"sourcesContent":["import childProcess from 'node:child_process';\nimport fs from 'node:fs/promises';\nimport os from 'node:os';\nimport path from 'node:path';\nimport { hasErrorCode } from '@willbooster/shared-lib';\n\nexport interface SpawnWithLimitsResult {\n  stdout: string;\n  stderr: string;\n  status: number | undefined;\n  signal: NodeJS.Signals | undefined;\n  /** Wall time measured by GNU time, or measured here until the command exited when it produced none. */\n  timeSeconds: number;\n  /**\n   * User plus system CPU time of the command and the descendants it waited for, measured by GNU\n   * time, or 0 when it produced no measurement. A run `timeout` ended is measured too, so a caller\n   * can tell a program that used up its time limit from one that waited for the CPU.\n   */\n  cpuTimeSeconds: number;\n  /**\n   * Peak resident set size measured by GNU time, or 0 when it produced no measurement. GNU time\n   * measures its child `timeout` and the descendants it waited for, so the value is at least\n   * `timeout`'s own footprint (about 1 MiB), which only shows for the smallest native programs.\n   */\n  memoryBytes: number;\n  /** The note GNU time adds when the command exits abnormally, e.g. `Command terminated by signal 11`. */\n  timeCommandMessage: string | undefined;\n  timedOut: boolean;\n  outputLimitExceeded: boolean;\n}\n\nconst killGracePeriodMilliseconds = 1000;\nconst MIN_TIMEOUT_SECONDS = 0.001;\n// GNU `timeout` exits with 124 after ending a run at its limit, or with 128 + SIGKILL when the run\n// ignored its SIGTERM and it had to be killed after the grace period.\nconst TIMEOUT_EXIT_STATUS = 124;\nconst KILLED_AFTER_TIMEOUT_EXIT_STATUS = 137;\n// GNU time writes its record to a file this process opened and unlinked at once, handed down as fd 3\n// of the command and reopened by GNU time through `/dev/fd`: the command runs as the same OS user,\n// so a record reachable by path could be swapped for a fake or for a FIFO that blocks the read.\nconst TIME_OUTPUT_FD = 3;\n// The command inherits that descriptor too, so only the tail that can hold GNU time's record is read.\nconst TIME_OUTPUT_TAIL_BYTES = 4096;\nconst timeCommand = resolveTimeCommand();\n\n/** Whether GNU time is available, i.e. whether `timeSeconds`, `cpuTimeSeconds`, and `memoryBytes` are measured at all. */\nexport const isTimeCommandAvailable = timeCommand !== undefined;\n\n// The commands run in their own sessions, so they outlive this process unless it ends them itself\n// on the way out (e.g. a preset's SIGINT handler calling `process.exit`).\nconst liveSubprocesses = new Set<childProcess.ChildProcess>();\nprocess.once('exit', () => {\n  for (const subprocess of liveSubprocesses) killSubprocessGroup(subprocess, 'SIGKILL');\n});\n\n/**\n * Runs a command in its own process group with `stdin` piped in, killing the whole group once it\n * exceeds the time or output limit, and reports the wall time, CPU time, and peak memory measured\n * by GNU time.\n */\nexport async function spawnWithLimits(\n  command: readonly [string, ...string[]],\n  context: {\n    cwd: string;\n    env: NodeJS.ProcessEnv;\n    outputLimitBytes: number;\n    stdin: string;\n    timeLimitSeconds: number;\n  }\n): Promise<SpawnWithLimitsResult> {\n  const timeOutput = timeCommand === undefined ? undefined : await openUnlinkedFile('exercode-time-');\n  try {\n    const detached = process.platform !== 'win32';\n    // The command runs in its own session so the group kill below cannot hit this process, but that\n    // also puts it out of reach of whoever kills this process. GNU `timeout` keeps the run bounded\n    // in that case, and it is what normally ends a run at its limit: GNU time wraps it, so a run\n    // that hit the limit still gets its CPU time recorded (a group kill from here would take GNU\n    // time down with the command), and `--foreground` keeps the command in this group so the kill\n    // below still reaches every descendant. The timers below only back `timeout` up. Should this\n    // process die first, `timeout` ends the command alone (`--foreground` signals no descendant),\n    // an accepted gap: the judge server sweeps every process of the request's sandbox user anyway.\n    const boundedCommand: readonly [string, ...string[]] = detached\n      ? [\n          'timeout',\n          '--foreground',\n          '-k',\n          String(killGracePeriodMilliseconds / 1000),\n          // A zero duration would disable `timeout`; the front matter allows a zero time limit.\n          String(Math.max(context.timeLimitSeconds, MIN_TIMEOUT_SECONDS)),\n          ...command,\n        ]\n      : command;\n    const spawnedCommand: readonly [string, ...string[]] =\n      timeCommand === undefined\n        ? boundedCommand\n        : [...timeCommand, `--output=/dev/fd/${TIME_OUTPUT_FD}`, ...boundedCommand];\n    // `timeout` sends SIGKILL a grace period after its SIGTERM; the timers here fire once even that\n    // should have ended the run.\n    const timeLimitMilliseconds = detached\n      ? context.timeLimitSeconds * 1000 + 2 * killGracePeriodMilliseconds\n      : context.timeLimitSeconds * 1000;\n    // Monotonic: a wall-clock step must not turn a run `timeout` ended into one that finished in time.\n    const startTimeMilliseconds = performance.now();\n    // The standard streams are always pipes; the type cannot express that with the extra entry.\n    const subprocess = childProcess.spawn(spawnedCommand[0], spawnedCommand.slice(1), {\n      cwd: context.cwd,\n      detached,\n      env: context.env,\n      stdio: timeOutput === undefined ? ['pipe', 'pipe', 'pipe'] : ['pipe', 'pipe', 'pipe', timeOutput.fd],\n    }) as childProcess.ChildProcessWithoutNullStreams;\n    liveSubprocesses.add(subprocess);\n\n    const stdoutChunks: Buffer[] = [];\n    const stderrChunks: Buffer[] = [];\n    let outputBytes = 0;\n    let timedOut = false;\n    let outputLimitExceeded = false;\n    let wallTimeSeconds = 0;\n    let spawnErrorMessage: string | undefined;\n\n    const appendOutputChunk = (chunks: Buffer[], chunk: Buffer): void => {\n      if (outputBytes >= context.outputLimitBytes) {\n        if (chunk.byteLength > 0) {\n          outputLimitExceeded = true;\n          killSubprocessGroup(subprocess, 'SIGKILL');\n        }\n        return;\n      }\n\n      const remainingBytes = context.outputLimitBytes - outputBytes;\n      const appendedChunk = chunk.byteLength > remainingBytes ? chunk.subarray(0, remainingBytes) : chunk;\n      chunks.push(appendedChunk);\n      outputBytes += appendedChunk.byteLength;\n\n      if (chunk.byteLength > remainingBytes) {\n        outputLimitExceeded = true;\n        killSubprocessGroup(subprocess, 'SIGKILL');\n      }\n    };\n\n    subprocess.stdout.on('data', (chunk: Buffer) => appendOutputChunk(stdoutChunks, chunk));\n    subprocess.stderr.on('data', (chunk: Buffer) => appendOutputChunk(stderrChunks, chunk));\n\n    const timeout = setTimeout(() => {\n      timedOut = true;\n      killSubprocessGroup(subprocess, 'SIGTERM');\n    }, timeLimitMilliseconds);\n    const killTimeout = setTimeout(() => {\n      if (timedOut) killSubprocessGroup(subprocess, 'SIGKILL');\n    }, timeLimitMilliseconds + killGracePeriodMilliseconds);\n    killTimeout.unref();\n\n    const { status, signal } = await new Promise<{ status: number | undefined; signal: NodeJS.Signals | undefined }>(\n      (resolve, reject) => {\n        let settled = false;\n        let pendingError: Error | undefined;\n        let closeTimeout: NodeJS.Timeout | undefined;\n        const settle = (code: number | null | undefined, exitSignal: NodeJS.Signals | null | undefined): void => {\n          if (settled) return;\n          settled = true;\n          clearTimeout(closeTimeout);\n          if (pendingError) {\n            reject(pendingError);\n            return;\n          }\n          resolve({ status: code ?? undefined, signal: exitSignal ?? undefined });\n        };\n        const failAfterClose = (error: Error): void => {\n          if (settled) return;\n          if (subprocess.pid === undefined) {\n            // The spawn itself failed, i.e. the head of the chain (GNU time, or `timeout` without\n            // it, or the command itself on Windows) or the cwd is missing. A missing judged command\n            // is reported as status 127 by the wrapper instead. Report this like a run that produced\n            // only this message.\n            spawnErrorMessage = error.message;\n            settle(undefined, undefined);\n            return;\n          }\n          pendingError = error;\n          killSubprocessGroup(subprocess, 'SIGKILL');\n        };\n        subprocess.on('error', failAfterClose);\n        subprocess.stdin.on('error', (error: NodeJS.ErrnoException) => {\n          if (error.code !== 'EPIPE') failAfterClose(error);\n        });\n        subprocess.on('exit', (code, exitSignal) => {\n          // The command is gone, so the limit timers must not fire during the grace period below. A\n          // descendant that inherited the pipes (e.g. `sleep 1000 &`) would keep them open and hold\n          // back 'close' until it ends: kill what is left of the group. A descendant that moved to\n          // its own session survives that, so stop waiting for the pipes after the grace period and\n          // keep the output read so far.\n          clearTimeout(timeout);\n          clearTimeout(killTimeout);\n          wallTimeSeconds = (performance.now() - startTimeMilliseconds) / 1000;\n          killSubprocessGroup(subprocess, 'SIGKILL');\n          closeTimeout = setTimeout(() => {\n            subprocess.stdout.destroy();\n            subprocess.stderr.destroy();\n            settle(code, exitSignal);\n          }, killGracePeriodMilliseconds);\n        });\n        subprocess.on('close', settle);\n        subprocess.stdin.end(context.stdin);\n      }\n    ).finally(() => {\n      clearTimeout(timeout);\n      clearTimeout(killTimeout);\n      liveSubprocesses.delete(subprocess);\n    });\n\n    const timeResult =\n      timeOutput === undefined ? undefined : parseTimeOutput(await readTail(timeOutput, TIME_OUTPUT_TAIL_BYTES));\n\n    return {\n      stdout: Buffer.concat(stdoutChunks).toString(),\n      stderr: spawnErrorMessage ?? Buffer.concat(stderrChunks).toString(),\n      status,\n      signal,\n      // GNU time rounds a fast run to 0.00; the wall time until 'exit' stands in for it (never the\n      // grace period spent on the pipes afterwards).\n      timeSeconds: timeResult?.timeSeconds || wallTimeSeconds,\n      cpuTimeSeconds: timeResult?.cpuTimeSeconds ?? 0,\n      memoryBytes: timeResult?.memoryBytes ?? 0,\n      timeCommandMessage: timeResult?.message,\n      timedOut: timedOut || endedByTimeout(status, wallTimeSeconds, context.timeLimitSeconds),\n      outputLimitExceeded,\n    };\n  } finally {\n    await timeOutput?.close();\n  }\n}\n\n/**\n * Whether `timeout` ended the run: 124 says it did so at the limit, and 137 that the run ignored its\n * SIGTERM and had to be killed after the grace period. A program can exit with either status on its\n * own, so each is trusted only once the wall time reached the moment `timeout` would have produced it.\n */\nfunction endedByTimeout(status: number | undefined, wallTimeSeconds: number, timeLimitSeconds: number): boolean {\n  if (status === TIMEOUT_EXIT_STATUS) return wallTimeSeconds >= timeLimitSeconds;\n  if (status === KILLED_AFTER_TIMEOUT_EXIT_STATUS) {\n    return wallTimeSeconds >= timeLimitSeconds + killGracePeriodMilliseconds / 1000;\n  }\n  return false;\n}\n\nfunction killSubprocessGroup(subprocess: childProcess.ChildProcess, signal: NodeJS.Signals): void {\n  if (subprocess.pid === undefined) return;\n\n  try {\n    if (process.platform === 'win32') {\n      subprocess.kill(signal);\n      return;\n    }\n    process.kill(-subprocess.pid, signal);\n  } catch (error) {\n    if (!hasErrorCode(error, 'ESRCH') && !hasErrorCode(error, 'EPERM')) throw error;\n  }\n}\n\n// The file is unlinked before it is returned, so nothing can reach it by path anymore.\nasync function openUnlinkedFile(prefix: string): Promise<fs.FileHandle> {\n  const directory = await fs.mkdtemp(path.join(os.tmpdir(), prefix));\n  try {\n    return await fs.open(path.join(directory, 'record'), 'wx+', 0o600);\n  } finally {\n    await fs.rm(directory, { recursive: true, force: true });\n  }\n}\n\nasync function readTail(file: fs.FileHandle, maxBytes: number): Promise<string> {\n  const { size } = await file.stat();\n  const length = Math.min(size, maxBytes);\n  const { buffer } = await file.read(Buffer.alloc(length), 0, length, size - length);\n  return buffer.toString();\n}\n\n// Empty when the command was killed before GNU time wrote its record.\nfunction parseTimeOutput(\n  content: string\n): { timeSeconds: number; cpuTimeSeconds: number; memoryBytes: number; message: string | undefined } | undefined {\n  const match = /(?:^|\\n)(\\d+(?:[.,]\\d+)?) (\\d+(?:[.,]\\d+)?) (\\d+(?:[.,]\\d+)?) (\\d+)\\s*$/.exec(content);\n  if (!match) return undefined;\n\n  return {\n    timeSeconds: parseSeconds(match[1]!),\n    cpuTimeSeconds: parseSeconds(match[2]!) + parseSeconds(match[3]!),\n    memoryBytes: Number(match[4]) * 1024,\n    message: content.slice(0, match.index).trim() || undefined,\n  };\n}\n\n// GNU time formats its seconds with the locale's decimal separator.\nfunction parseSeconds(text: string): number {\n  return Number(text.replace(',', '.'));\n}\n\nfunction resolveTimeCommand(): readonly [string, ...string[]] | undefined {\n  const command = os.platform() === 'darwin' ? 'gtime' : '/usr/bin/time';\n  const result = childProcess.spawnSync(command, ['--version'], { stdio: 'ignore' });\n  if (result.error || result.status !== 0) return undefined;\n\n  // Wall seconds, user CPU seconds, system CPU seconds, peak resident set size in KiB.\n  return [command, '--format', '%e %U %S %M'];\n}\n"],"mappings":"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"}

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./helpers/compareStdoutAsSpaceSeparatedTokens.cjs"),t=require("./types/testCaseResult.cjs"),n=require("./helpers/printTestCaseResult.cjs"),r=require("./helpers/compareExpectedOutputFiles.cjs"),i=require("./helpers/defaultStdioHarness.cjs"),a=require("./helpers/parseArgs.cjs"),o=require("./helpers/parseCsv.cjs"),s=require("./helpers/readTestCases.cjs"),c=require("./helpers/removeCommentsInSourceCode.cjs"),l=require("./helpers/runCommandInTemporaryPackageManagerProject.cjs"),u=require("./helpers/runPythonInTemporaryUvProject.cjs"),d=require("./helpers/sourceCodeGrammars.cjs"),f=require("./helpers/startHttpServer.cjs"),p=require("./types/problem.cjs"),m=require("./learningMaterial/frontmatter.cjs"),h=require("./learningMaterial/validationResult.cjs"),g=require("./learningMaterial/validateMaterial.cjs"),_=require("./learningMaterial/validateContest.cjs"),v=require("./learningMaterial/validateCourse.cjs"),y=require("./learningMaterial/validateProblem.cjs"),b=require("./types/decisionCode.cjs");exports.CsvParseError=o.CsvParseError,exports.DecisionCode=b.DecisionCode,exports.HARNESS_FILE_PRESETS=i.HARNESS_FILE_PRESETS,exports.MAX_COMPARED_FILE_BYTES=r.MAX_COMPARED_FILE_BYTES,exports.MAX_REPORTED_FILE_BYTES=r.MAX_REPORTED_FILE_BYTES,exports.TEST_CASE_RESULT_PREFIX=t.TEST_CASE_RESULT_PREFIX,exports.codeRuleSchema=p.codeRuleSchema,exports.compareExpectedOutputFiles=r.compareExpectedOutputFiles,exports.compareStdoutAsSpaceSeparatedTokens=e.compareStdoutAsSpaceSeparatedTokens,exports.copyPackageManagerProjectFiles=l.copyPackageManagerProjectFiles,exports.encodeFileForTestCaseResult=n.encodeFileForTestCaseResult,exports.findDefaultStdioHarnessFiles=i.findDefaultStdioHarnessFiles,exports.formatValidationReport=h.formatValidationReport,exports.formatZodIssues=h.formatZodIssues,exports.isDefaultStdioHarnessSource=i.isDefaultStdioHarnessSource,exports.judgeAgainstExpectations=r.judgeAgainstExpectations,exports.languageIdToSourceCodeGrammar=d.languageIdToSourceCodeGrammar,exports.mergeComparisonOutputFiles=r.mergeComparisonOutputFiles,exports.mergeSubmissionPeriods=g.mergeSubmissionPeriods,exports.normalizeCodeRule=p.normalizeCodeRule,exports.parseArgs=a.parseArgs,exports.parseCsv=o.parseCsv,exports.parseCsvRecords=o.parseCsvRecords,exports.parseFrontmatter=m.parseFrontmatter,exports.printTestCaseResult=n.printTestCaseResult,exports.problemMarkdownFrontMatterSchema=p.problemMarkdownFrontMatterSchema,exports.readTestCases=s.readTestCases,exports.removeCommentsAndStringsInSourceCode=c.removeCommentsAndStringsInSourceCode,exports.removeCommentsInSourceCode=c.removeCommentsInSourceCode,exports.reportDuplicateIds=h.reportDuplicateIds,exports.reportExcessChatMarkers=g.reportExcessChatMarkers,exports.reportForeignProblemCourseIds=g.reportForeignProblemCourseIds,exports.runCommandInTemporaryPackageManagerProject=l.runCommandInTemporaryPackageManagerProject,exports.runPythonInTemporaryUvProject=u.runPythonInTemporaryUvProject,exports.startHttpServer=f.startHttpServer,exports.startLocalHttpServer=f.startLocalHttpServer,exports.testCaseResultSchema=t.testCaseResultSchema,exports.validateContestFile=_.validateContestFile,exports.validateCourseDirectory=v.validateCourseDirectory,exports.validateMaterialFile=g.validateMaterialFile,exports.validateProblemDirectory=y.validateProblemDirectory,exports.validateSubmissionPeriods=g.validateSubmissionPeriods;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./helpers/compareStdoutAsSpaceSeparatedTokens.cjs"),t=require("./types/testCaseResult.cjs"),n=require("./helpers/printTestCaseResult.cjs"),r=require("./helpers/compareExpectedOutputFiles.cjs"),i=require("./helpers/defaultStdioHarness.cjs"),a=require("./helpers/parseArgs.cjs"),o=require("./helpers/parseCsv.cjs"),s=require("./helpers/readTestCases.cjs"),c=require("./helpers/removeCommentsInSourceCode.cjs"),l=require("./helpers/runCommandInTemporaryPackageManagerProject.cjs"),u=require("./helpers/runPythonInTemporaryUvProject.cjs"),d=require("./helpers/sourceCodeGrammars.cjs"),f=require("./helpers/startHttpServer.cjs"),p=require("./types/problem.cjs"),m=require("./learningMaterial/frontmatter.cjs"),h=require("./learningMaterial/validationResult.cjs"),g=require("./learningMaterial/validateMaterial.cjs"),_=require("./learningMaterial/validateContest.cjs"),v=require("./learningMaterial/validateCourse.cjs"),y=require("./learningMaterial/validateProblem.cjs"),b=require("./types/decisionCode.cjs"),x=require("./helpers/guiRecording.cjs");exports.CsvParseError=o.CsvParseError,exports.DecisionCode=b.DecisionCode,exports.HARNESS_FILE_PRESETS=i.HARNESS_FILE_PRESETS,exports.MAX_COMPARED_FILE_BYTES=r.MAX_COMPARED_FILE_BYTES,exports.MAX_GUI_RECORDING_BYTES=x.MAX_GUI_RECORDING_BYTES,exports.MAX_REPORTED_FILE_BYTES=r.MAX_REPORTED_FILE_BYTES,exports.TEST_CASE_RESULT_PREFIX=t.TEST_CASE_RESULT_PREFIX,exports.codeRuleSchema=p.codeRuleSchema,exports.compareExpectedOutputFiles=r.compareExpectedOutputFiles,exports.compareStdoutAsSpaceSeparatedTokens=e.compareStdoutAsSpaceSeparatedTokens,exports.copyPackageManagerProjectFiles=l.copyPackageManagerProjectFiles,exports.encodeFileForTestCaseResult=n.encodeFileForTestCaseResult,exports.findDefaultStdioHarnessFiles=i.findDefaultStdioHarnessFiles,exports.formatValidationReport=h.formatValidationReport,exports.formatZodIssues=h.formatZodIssues,exports.isDefaultStdioHarnessSource=i.isDefaultStdioHarnessSource,exports.judgeAgainstExpectations=r.judgeAgainstExpectations,exports.languageIdToSourceCodeGrammar=d.languageIdToSourceCodeGrammar,exports.mergeComparisonOutputFiles=r.mergeComparisonOutputFiles,exports.mergeSubmissionPeriods=g.mergeSubmissionPeriods,exports.normalizeCodeRule=p.normalizeCodeRule,exports.parseArgs=a.parseArgs,exports.parseCsv=o.parseCsv,exports.parseCsvRecords=o.parseCsvRecords,exports.parseFrontmatter=m.parseFrontmatter,exports.printTestCaseResult=n.printTestCaseResult,exports.problemMarkdownFrontMatterSchema=p.problemMarkdownFrontMatterSchema,exports.readTestCases=s.readTestCases,exports.removeCommentsAndStringsInSourceCode=c.removeCommentsAndStringsInSourceCode,exports.removeCommentsInSourceCode=c.removeCommentsInSourceCode,exports.reportDuplicateIds=h.reportDuplicateIds,exports.reportExcessChatMarkers=g.reportExcessChatMarkers,exports.reportForeignProblemCourseIds=g.reportForeignProblemCourseIds,exports.runCommandInTemporaryPackageManagerProject=l.runCommandInTemporaryPackageManagerProject,exports.runPythonInTemporaryUvProject=u.runPythonInTemporaryUvProject,exports.startHttpServer=f.startHttpServer,exports.startLocalHttpServer=f.startLocalHttpServer,exports.testCaseResultSchema=t.testCaseResultSchema,exports.validateContestFile=_.validateContestFile,exports.validateCourseDirectory=v.validateCourseDirectory,exports.validateMaterialFile=g.validateMaterialFile,exports.validateProblemDirectory=y.validateProblemDirectory,exports.validateSubmissionPeriods=g.validateSubmissionPeriods;

package/dist/index.d.ts

@@ -18,4 +18,5 @@ export * from './learningMaterial/validationResult.js';
 export * from './types/decisionCode.js';
 export * from './types/problem.js';
 export * from './types/testCaseResult.js';
+export { MAX_GUI_RECORDING_BYTES } from './helpers/guiRecording.js';
 export { parseFrontmatter } from './learningMaterial/frontmatter.js';

package/dist/index.js

@@ -1 +1 @@
-import{compareStdoutAsSpaceSeparatedTokens as e}from"./helpers/compareStdoutAsSpaceSeparatedTokens.js";import{TEST_CASE_RESULT_PREFIX as t,testCaseResultSchema as n}from"./types/testCaseResult.js";import{encodeFileForTestCaseResult as r,printTestCaseResult as i}from"./helpers/printTestCaseResult.js";import{MAX_COMPARED_FILE_BYTES as a,MAX_REPORTED_FILE_BYTES as o,compareExpectedOutputFiles as s,judgeAgainstExpectations as c,mergeComparisonOutputFiles as l}from"./helpers/compareExpectedOutputFiles.js";import{HARNESS_FILE_PRESETS as u,findDefaultStdioHarnessFiles as d,isDefaultStdioHarnessSource as f}from"./helpers/defaultStdioHarness.js";import{parseArgs as p}from"./helpers/parseArgs.js";import{CsvParseError as m,parseCsv as h,parseCsvRecords as g}from"./helpers/parseCsv.js";import{readTestCases as _}from"./helpers/readTestCases.js";import{removeCommentsAndStringsInSourceCode as v,removeCommentsInSourceCode as y}from"./helpers/removeCommentsInSourceCode.js";import{copyPackageManagerProjectFiles as b,runCommandInTemporaryPackageManagerProject as x}from"./helpers/runCommandInTemporaryPackageManagerProject.js";import{runPythonInTemporaryUvProject as S}from"./helpers/runPythonInTemporaryUvProject.js";import{languageIdToSourceCodeGrammar as C}from"./helpers/sourceCodeGrammars.js";import{startHttpServer as w,startLocalHttpServer as T}from"./helpers/startHttpServer.js";import{codeRuleSchema as E,normalizeCodeRule as D,problemMarkdownFrontMatterSchema as O}from"./types/problem.js";import{parseFrontmatter as k}from"./learningMaterial/frontmatter.js";import{formatValidationReport as A,formatZodIssues as j,reportDuplicateIds as M}from"./learningMaterial/validationResult.js";import{mergeSubmissionPeriods as N,reportExcessChatMarkers as P,reportForeignProblemCourseIds as F,validateMaterialFile as I,validateSubmissionPeriods as L}from"./learningMaterial/validateMaterial.js";import{validateContestFile as R}from"./learningMaterial/validateContest.js";import{validateCourseDirectory as z}from"./learningMaterial/validateCourse.js";import{validateProblemDirectory as B}from"./learningMaterial/validateProblem.js";import{DecisionCode as V}from"./types/decisionCode.js";export{m as CsvParseError,V as DecisionCode,u as HARNESS_FILE_PRESETS,a as MAX_COMPARED_FILE_BYTES,o as MAX_REPORTED_FILE_BYTES,t as TEST_CASE_RESULT_PREFIX,E as codeRuleSchema,s as compareExpectedOutputFiles,e as compareStdoutAsSpaceSeparatedTokens,b as copyPackageManagerProjectFiles,r as encodeFileForTestCaseResult,d as findDefaultStdioHarnessFiles,A as formatValidationReport,j as formatZodIssues,f as isDefaultStdioHarnessSource,c as judgeAgainstExpectations,C as languageIdToSourceCodeGrammar,l as mergeComparisonOutputFiles,N as mergeSubmissionPeriods,D as normalizeCodeRule,p as parseArgs,h as parseCsv,g as parseCsvRecords,k as parseFrontmatter,i as printTestCaseResult,O as problemMarkdownFrontMatterSchema,_ as readTestCases,v as removeCommentsAndStringsInSourceCode,y as removeCommentsInSourceCode,M as reportDuplicateIds,P as reportExcessChatMarkers,F as reportForeignProblemCourseIds,x as runCommandInTemporaryPackageManagerProject,S as runPythonInTemporaryUvProject,w as startHttpServer,T as startLocalHttpServer,n as testCaseResultSchema,R as validateContestFile,z as validateCourseDirectory,I as validateMaterialFile,B as validateProblemDirectory,L as validateSubmissionPeriods};
+import{compareStdoutAsSpaceSeparatedTokens as e}from"./helpers/compareStdoutAsSpaceSeparatedTokens.js";import{TEST_CASE_RESULT_PREFIX as t,testCaseResultSchema as n}from"./types/testCaseResult.js";import{encodeFileForTestCaseResult as r,printTestCaseResult as i}from"./helpers/printTestCaseResult.js";import{MAX_COMPARED_FILE_BYTES as a,MAX_REPORTED_FILE_BYTES as o,compareExpectedOutputFiles as s,judgeAgainstExpectations as c,mergeComparisonOutputFiles as l}from"./helpers/compareExpectedOutputFiles.js";import{HARNESS_FILE_PRESETS as u,findDefaultStdioHarnessFiles as d,isDefaultStdioHarnessSource as f}from"./helpers/defaultStdioHarness.js";import{parseArgs as p}from"./helpers/parseArgs.js";import{CsvParseError as m,parseCsv as h,parseCsvRecords as g}from"./helpers/parseCsv.js";import{readTestCases as _}from"./helpers/readTestCases.js";import{removeCommentsAndStringsInSourceCode as v,removeCommentsInSourceCode as y}from"./helpers/removeCommentsInSourceCode.js";import{copyPackageManagerProjectFiles as b,runCommandInTemporaryPackageManagerProject as x}from"./helpers/runCommandInTemporaryPackageManagerProject.js";import{runPythonInTemporaryUvProject as S}from"./helpers/runPythonInTemporaryUvProject.js";import{languageIdToSourceCodeGrammar as C}from"./helpers/sourceCodeGrammars.js";import{startHttpServer as w,startLocalHttpServer as T}from"./helpers/startHttpServer.js";import{codeRuleSchema as E,normalizeCodeRule as D,problemMarkdownFrontMatterSchema as O}from"./types/problem.js";import{parseFrontmatter as k}from"./learningMaterial/frontmatter.js";import{formatValidationReport as A,formatZodIssues as j,reportDuplicateIds as M}from"./learningMaterial/validationResult.js";import{mergeSubmissionPeriods as N,reportExcessChatMarkers as P,reportForeignProblemCourseIds as F,validateMaterialFile as I,validateSubmissionPeriods as L}from"./learningMaterial/validateMaterial.js";import{validateContestFile as R}from"./learningMaterial/validateContest.js";import{validateCourseDirectory as z}from"./learningMaterial/validateCourse.js";import{validateProblemDirectory as B}from"./learningMaterial/validateProblem.js";import{DecisionCode as V}from"./types/decisionCode.js";import{MAX_GUI_RECORDING_BYTES as H}from"./helpers/guiRecording.js";export{m as CsvParseError,V as DecisionCode,u as HARNESS_FILE_PRESETS,a as MAX_COMPARED_FILE_BYTES,H as MAX_GUI_RECORDING_BYTES,o as MAX_REPORTED_FILE_BYTES,t as TEST_CASE_RESULT_PREFIX,E as codeRuleSchema,s as compareExpectedOutputFiles,e as compareStdoutAsSpaceSeparatedTokens,b as copyPackageManagerProjectFiles,r as encodeFileForTestCaseResult,d as findDefaultStdioHarnessFiles,A as formatValidationReport,j as formatZodIssues,f as isDefaultStdioHarnessSource,c as judgeAgainstExpectations,C as languageIdToSourceCodeGrammar,l as mergeComparisonOutputFiles,N as mergeSubmissionPeriods,D as normalizeCodeRule,p as parseArgs,h as parseCsv,g as parseCsvRecords,k as parseFrontmatter,i as printTestCaseResult,O as problemMarkdownFrontMatterSchema,_ as readTestCases,v as removeCommentsAndStringsInSourceCode,y as removeCommentsInSourceCode,M as reportDuplicateIds,P as reportExcessChatMarkers,F as reportForeignProblemCourseIds,x as runCommandInTemporaryPackageManagerProject,S as runPythonInTemporaryUvProject,w as startHttpServer,T as startLocalHttpServer,n as testCaseResultSchema,R as validateContestFile,z as validateCourseDirectory,I as validateMaterialFile,B as validateProblemDirectory,L as validateSubmissionPeriods};

package/dist/learningMaterial/fsHelpers.cjs

@@ -1,2 +1,2 @@
-"use strict";const e=require("./schemas.cjs");let t=require("node:path"),n=require("node:fs/promises");const r=new Set([`__pycache__`]),i=new Set([``,`.class`,`.exe`,`.jar`,`.out`,`.pyc`,`.png`,`.gif`]);async function a(e){try{return(await(0,n.stat)(e)).isFile()}catch{return!1}}async function o(e){try{return(await(0,n.lstat)(e)).isFile()}catch{return!1}}async function s(e){try{return(await(0,n.lstat)(e)).isDirectory()}catch{return!1}}async function c(e){try{return(await(0,n.stat)(e)).isDirectory()}catch{return!1}}async function l(e){let t=new Map;return await u(e,e,t),t}async function u(e,r,i){let a=await(0,n.readdir)(r,{withFileTypes:!0});if(!(r!==e&&a.some(e=>e.isFile()&&(e.name===`course.yaml`||e.name===`course.yml`))))for(let n of a)if(n.isFile()){let a=n.name===`problem.md`?(0,t.basename)(r):n.name.endsWith(`.problem.md`)?n.name.slice(0,-11).toLowerCase():void 0;if(a===void 0)continue;let o=i.get(a)??[];o.push((0,t.relative)(e,(0,t.join)(r,n.name))),i.set(a,o)}else n.isDirectory()&&!d(r,n.name)&&await u(e,(0,t.join)(r,n.name),i)}function d(e,n){return n.startsWith(`.`)||n===`node_modules`||n===`target`||n===`temp`&&(0,t.basename)(e)===`judge-environments`}function f(t,n){for(let[r,i]of t)e.LEARNING_MATERIAL_ID_REGEX.test(r)||n.push(`problem ID "${r}" (${i.join(`, `)}) must match ${e.LEARNING_MATERIAL_ID_REGEX}; the judge aborts discovery on it`),i.length>1&&n.push(`problem ID "${r}" is defined more than once (${i.join(`, `)}); the judge rejects the conflict`)}async function p(e,t){return await s(e)?!0:(t.push(await c(e)?`problems directory is a symbolic link, which the judge does not traverse: ${e}`:`problems directory not found: ${e}`),!1)}async function m(e,t){if(!await p(e,t))return;let n=await l(e);return f(n,t),new Set(n.keys())}function h(e,t,n,r){let i=n===void 0?``:` under ${n}`;for(let n of new Set(e))t.has(n)||r.push(`problem "${n}" is referenced but does not exist${i}`)}async function g(e){let t=[];return await _(e,e,t),t.toSorted((e,t)=>e.path.localeCompare(t.path))}async function _(e,a,o){for(let s of await(0,n.readdir)(a,{withFileTypes:!0})){let c=(0,t.join)(a,s.name);s.isDirectory()?r.has(s.name)||await _(e,c,o):s.isFile()&&!i.has((0,t.extname)(s.name).toLowerCase())&&o.push({path:(0,t.relative)(e,c),data:await(0,n.readFile)(c,`utf8`)})}}exports.collectProblemDefinitions=l,exports.collectProblemIdsFromDirectory=m,exports.isDirectory=c,exports.isFile=a,exports.isRegularDirectory=s,exports.isRegularFile=o,exports.isUsableProblemsDirectory=p,exports.readSourceFilesRecursively=g,exports.reportDanglingProblemReferences=h,exports.reportProblemDefinitionIssues=f;
+"use strict";const e=require("./schemas.cjs");let t=require("node:path"),n=require("node:fs/promises");const r=/* @__PURE__ */ new Set([`__pycache__`]),i=/* @__PURE__ */ new Set([``,`.class`,`.exe`,`.jar`,`.out`,`.pyc`,`.png`,`.gif`]);async function a(e){try{return(await(0,n.stat)(e)).isFile()}catch{return!1}}async function o(e){try{return(await(0,n.lstat)(e)).isFile()}catch{return!1}}async function s(e){try{return(await(0,n.lstat)(e)).isDirectory()}catch{return!1}}async function c(e){try{return(await(0,n.stat)(e)).isDirectory()}catch{return!1}}async function l(e){let t=/* @__PURE__ */ new Map;return await u(e,e,t),t}async function u(e,r,i){let a=await(0,n.readdir)(r,{withFileTypes:!0});if(!(r!==e&&a.some(e=>e.isFile()&&(e.name===`course.yaml`||e.name===`course.yml`))))for(let n of a)if(n.isFile()){let a=n.name===`problem.md`?(0,t.basename)(r):n.name.endsWith(`.problem.md`)?n.name.slice(0,-11).toLowerCase():void 0;if(a===void 0)continue;let o=i.get(a)??[];o.push((0,t.relative)(e,(0,t.join)(r,n.name))),i.set(a,o)}else n.isDirectory()&&!d(r,n.name)&&await u(e,(0,t.join)(r,n.name),i)}function d(e,n){return n.startsWith(`.`)||n===`node_modules`||n===`target`||n===`temp`&&(0,t.basename)(e)===`judge-environments`}function f(t,n){for(let[r,i]of t)e.LEARNING_MATERIAL_ID_REGEX.test(r)||n.push(`problem ID "${r}" (${i.join(`, `)}) must match ${e.LEARNING_MATERIAL_ID_REGEX}; the judge aborts discovery on it`),i.length>1&&n.push(`problem ID "${r}" is defined more than once (${i.join(`, `)}); the judge rejects the conflict`)}async function p(e,t){return await s(e)?!0:(t.push(await c(e)?`problems directory is a symbolic link, which the judge does not traverse: ${e}`:`problems directory not found: ${e}`),!1)}async function m(e,t){if(!await p(e,t))return;let n=await l(e);return f(n,t),new Set(n.keys())}function h(e,t,n,r){let i=n===void 0?``:` under ${n}`;for(let n of new Set(e))t.has(n)||r.push(`problem "${n}" is referenced but does not exist${i}`)}async function g(e){let t=[];return await _(e,e,t),t.toSorted((e,t)=>e.path.localeCompare(t.path))}async function _(e,a,o){for(let s of await(0,n.readdir)(a,{withFileTypes:!0})){let c=(0,t.join)(a,s.name);s.isDirectory()?r.has(s.name)||await _(e,c,o):s.isFile()&&!i.has((0,t.extname)(s.name).toLowerCase())&&o.push({path:(0,t.relative)(e,c),data:await(0,n.readFile)(c,`utf8`)})}}exports.collectProblemDefinitions=l,exports.collectProblemIdsFromDirectory=m,exports.isDirectory=c,exports.isFile=a,exports.isRegularDirectory=s,exports.isRegularFile=o,exports.isUsableProblemsDirectory=p,exports.readSourceFilesRecursively=g,exports.reportDanglingProblemReferences=h,exports.reportProblemDefinitionIssues=f;
 //# sourceMappingURL=fsHelpers.cjs.map

package/dist/learningMaterial/fsHelpers.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"fsHelpers.cjs","names":["stat","lstat","readdir","basename","relative","join","LEARNING_MATERIAL_ID_REGEX","extname","readFile"],"sources":["../../src/learningMaterial/fsHelpers.ts"],"sourcesContent":["import { lstat, readdir, readFile, stat } from 'node:fs/promises';\nimport { basename, extname, join, relative } from 'node:path';\n\nimport { LEARNING_MATERIAL_ID_REGEX } from './schemas.js';\n\n// Files the judge importer skips when reading problem directories. The extension filter is ported\n// from the judge's readSourceCodeFilesInDirectory so compile artifacts (e.g. Main.class next to\n// Main.java) are excluded from pattern checks exactly like the judge excludes them at import time;\n// the '' entry also drops dot files such as `.DS_Store`, whose extension is ''.\nconst IGNORED_DIRECTORY_NAMES: ReadonlySet<string> = new Set(['__pycache__']);\nconst NON_CODE_EXTENSIONS: ReadonlySet<string> = new Set([\n  '',\n  '.class',\n  '.exe',\n  '.jar',\n  '.out',\n  '.pyc',\n  '.png',\n  '.gif',\n]);\n\nexport interface SourceFile {\n  path: string;\n  data: string;\n}\n\nexport async function isFile(path: string): Promise<boolean> {\n  try {\n    const stats = await stat(path);\n    return stats.isFile();\n  } catch {\n    return false;\n  }\n}\n\n/** Whether the path is a regular file (not a symlink), as the judge's problem discovery requires. */\nexport async function isRegularFile(path: string): Promise<boolean> {\n  try {\n    const stats = await lstat(path);\n    return stats.isFile();\n  } catch {\n    return false;\n  }\n}\n\n/** Whether the path is a directory that is not a symbolic link, which the judge's discovery does not traverse. */\nexport async function isRegularDirectory(path: string): Promise<boolean> {\n  try {\n    const stats = await lstat(path);\n    return stats.isDirectory();\n  } catch {\n    return false;\n  }\n}\n\nexport async function isDirectory(path: string): Promise<boolean> {\n  try {\n    const stats = await stat(path);\n    return stats.isDirectory();\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Collects the problem definitions under a directory the way the judge discovers them: `problem.md`\n * names its directory and `<id>.problem.md` names itself, at any depth, without traversing symbolic\n * links or a nested course (whose problems belong to that nearer course). The result maps each\n * problem ID to the paths of its definitions (relative to the root); the judge rejects an ID\n * defined more than once.\n */\nexport async function collectProblemDefinitions(rootDirectoryPath: string): Promise<Map<string, string[]>> {\n  const definitionPathsById = new Map<string, string[]>();\n  await collectProblemDefinitionsInto(rootDirectoryPath, rootDirectoryPath, definitionPathsById);\n  return definitionPathsById;\n}\n\nasync function collectProblemDefinitionsInto(\n  rootDirectoryPath: string,\n  directoryPath: string,\n  definitionPathsById: Map<string, string[]>\n): Promise<void> {\n  const dirents = await readdir(directoryPath, { withFileTypes: true });\n  if (\n    directoryPath !== rootDirectoryPath &&\n    dirents.some((dirent) => dirent.isFile() && (dirent.name === 'course.yaml' || dirent.name === 'course.yml'))\n  ) {\n    return;\n  }\n  for (const dirent of dirents) {\n    if (dirent.isFile()) {\n      const problemId =\n        dirent.name === 'problem.md'\n          ? basename(directoryPath)\n          : dirent.name.endsWith('.problem.md')\n            ? // The judge lowercases a v1 file name before using it as the ID (a directory name is used as is).\n              dirent.name.slice(0, -'.problem.md'.length).toLowerCase()\n            : undefined;\n      if (problemId === undefined) continue;\n      const definitionPaths = definitionPathsById.get(problemId) ?? [];\n      definitionPaths.push(relative(rootDirectoryPath, join(directoryPath, dirent.name)));\n      definitionPathsById.set(problemId, definitionPaths);\n    } else if (dirent.isDirectory() && !isExcludedFromDiscovery(directoryPath, dirent.name)) {\n      await collectProblemDefinitionsInto(rootDirectoryPath, join(directoryPath, dirent.name), definitionPathsById);\n    }\n  }\n}\n\n// The judge's discovery glob skips dot directories and these excludes.\nfunction isExcludedFromDiscovery(parentDirectoryPath: string, directoryName: string): boolean {\n  return (\n    directoryName.startsWith('.') ||\n    directoryName === 'node_modules' ||\n    directoryName === 'target' ||\n    (directoryName === 'temp' && basename(parentDirectoryPath) === 'judge-environments')\n  );\n}\n\n/**\n * Reports discovered problem definitions the judge refuses: an ID that does not match the ID pattern\n * aborts discovery of the whole repository, and an ID defined more than once is a conflict.\n */\nexport function reportProblemDefinitionIssues(\n  definitionPathsById: ReadonlyMap<string, string[]>,\n  errors: string[]\n): void {\n  for (const [problemId, definitionPaths] of definitionPathsById) {\n    if (!LEARNING_MATERIAL_ID_REGEX.test(problemId)) {\n      errors.push(\n        `problem ID \"${problemId}\" (${definitionPaths.join(', ')}) must match ${LEARNING_MATERIAL_ID_REGEX}; the judge aborts discovery on it`\n      );\n    }\n    if (definitionPaths.length > 1) {\n      errors.push(\n        `problem ID \"${problemId}\" is defined more than once (${definitionPaths.join(', ')}); the judge rejects the conflict`\n      );\n    }\n  }\n}\n\n/** Reports a problems directory the judge cannot search (missing, or a symbolic link); returns whether it is usable. */\nexport async function isUsableProblemsDirectory(problemsDirectoryPath: string, errors: string[]): Promise<boolean> {\n  if (await isRegularDirectory(problemsDirectoryPath)) return true;\n  errors.push(\n    (await isDirectory(problemsDirectoryPath))\n      ? `problems directory is a symbolic link, which the judge does not traverse: ${problemsDirectoryPath}`\n      : `problems directory not found: ${problemsDirectoryPath}`\n  );\n  return false;\n}\n\n/** Collects the problem IDs a directory defines, reporting the issues the judge refuses; undefined when it cannot be searched. */\nexport async function collectProblemIdsFromDirectory(\n  problemsDirectoryPath: string,\n  errors: string[]\n): Promise<Set<string> | undefined> {\n  if (!(await isUsableProblemsDirectory(problemsDirectoryPath, errors))) return undefined;\n  const definitionPathsById = await collectProblemDefinitions(problemsDirectoryPath);\n  reportProblemDefinitionIssues(definitionPathsById, errors);\n  return new Set(definitionPathsById.keys());\n}\n\nexport function reportDanglingProblemReferences(\n  problemIds: Iterable<string>,\n  availableProblemIds: ReadonlySet<string>,\n  problemsDirectoryPath: string | undefined,\n  errors: string[]\n): void {\n  const location = problemsDirectoryPath === undefined ? '' : ` under ${problemsDirectoryPath}`;\n  for (const problemId of new Set(problemIds)) {\n    if (!availableProblemIds.has(problemId)) {\n      errors.push(`problem \"${problemId}\" is referenced but does not exist${location}`);\n    }\n  }\n}\n\n/** Reads all text files under a directory, with paths relative to the given root. */\nexport async function readSourceFilesRecursively(rootDirectoryPath: string): Promise<SourceFile[]> {\n  const files: SourceFile[] = [];\n  await collectSourceFiles(rootDirectoryPath, rootDirectoryPath, files);\n  return files.toSorted((f1, f2) => f1.path.localeCompare(f2.path));\n}\n\nasync function collectSourceFiles(\n  rootDirectoryPath: string,\n  directoryPath: string,\n  files: SourceFile[]\n): Promise<void> {\n  for (const dirent of await readdir(directoryPath, { withFileTypes: true })) {\n    const entryPath = join(directoryPath, dirent.name);\n    if (dirent.isDirectory()) {\n      if (!IGNORED_DIRECTORY_NAMES.has(dirent.name)) {\n        await collectSourceFiles(rootDirectoryPath, entryPath, files);\n      }\n    } else if (dirent.isFile() && !NON_CODE_EXTENSIONS.has(extname(dirent.name).toLowerCase())) {\n      files.push({ path: relative(rootDirectoryPath, entryPath), data: await readFile(entryPath, 'utf8') });\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"fsHelpers.cjs","names":["stat","lstat","readdir","basename","relative","join","LEARNING_MATERIAL_ID_REGEX","extname","readFile"],"sources":["../../src/learningMaterial/fsHelpers.ts"],"sourcesContent":["import { lstat, readdir, readFile, stat } from 'node:fs/promises';\nimport { basename, extname, join, relative } from 'node:path';\n\nimport { LEARNING_MATERIAL_ID_REGEX } from './schemas.js';\n\n// Files the judge importer skips when reading problem directories. The extension filter is ported\n// from the judge's readSourceCodeFilesInDirectory so compile artifacts (e.g. Main.class next to\n// Main.java) are excluded from pattern checks exactly like the judge excludes them at import time;\n// the '' entry also drops dot files such as `.DS_Store`, whose extension is ''.\nconst IGNORED_DIRECTORY_NAMES: ReadonlySet<string> = new Set(['__pycache__']);\nconst NON_CODE_EXTENSIONS: ReadonlySet<string> = new Set([\n  '',\n  '.class',\n  '.exe',\n  '.jar',\n  '.out',\n  '.pyc',\n  '.png',\n  '.gif',\n]);\n\nexport interface SourceFile {\n  path: string;\n  data: string;\n}\n\nexport async function isFile(path: string): Promise<boolean> {\n  try {\n    const stats = await stat(path);\n    return stats.isFile();\n  } catch {\n    return false;\n  }\n}\n\n/** Whether the path is a regular file (not a symlink), as the judge's problem discovery requires. */\nexport async function isRegularFile(path: string): Promise<boolean> {\n  try {\n    const stats = await lstat(path);\n    return stats.isFile();\n  } catch {\n    return false;\n  }\n}\n\n/** Whether the path is a directory that is not a symbolic link, which the judge's discovery does not traverse. */\nexport async function isRegularDirectory(path: string): Promise<boolean> {\n  try {\n    const stats = await lstat(path);\n    return stats.isDirectory();\n  } catch {\n    return false;\n  }\n}\n\nexport async function isDirectory(path: string): Promise<boolean> {\n  try {\n    const stats = await stat(path);\n    return stats.isDirectory();\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Collects the problem definitions under a directory the way the judge discovers them: `problem.md`\n * names its directory and `<id>.problem.md` names itself, at any depth, without traversing symbolic\n * links or a nested course (whose problems belong to that nearer course). The result maps each\n * problem ID to the paths of its definitions (relative to the root); the judge rejects an ID\n * defined more than once.\n */\nexport async function collectProblemDefinitions(rootDirectoryPath: string): Promise<Map<string, string[]>> {\n  const definitionPathsById = new Map<string, string[]>();\n  await collectProblemDefinitionsInto(rootDirectoryPath, rootDirectoryPath, definitionPathsById);\n  return definitionPathsById;\n}\n\nasync function collectProblemDefinitionsInto(\n  rootDirectoryPath: string,\n  directoryPath: string,\n  definitionPathsById: Map<string, string[]>\n): Promise<void> {\n  const dirents = await readdir(directoryPath, { withFileTypes: true });\n  if (\n    directoryPath !== rootDirectoryPath &&\n    dirents.some((dirent) => dirent.isFile() && (dirent.name === 'course.yaml' || dirent.name === 'course.yml'))\n  ) {\n    return;\n  }\n  for (const dirent of dirents) {\n    if (dirent.isFile()) {\n      const problemId =\n        dirent.name === 'problem.md'\n          ? basename(directoryPath)\n          : dirent.name.endsWith('.problem.md')\n            ? // The judge lowercases a v1 file name before using it as the ID (a directory name is used as is).\n              dirent.name.slice(0, -'.problem.md'.length).toLowerCase()\n            : undefined;\n      if (problemId === undefined) continue;\n      const definitionPaths = definitionPathsById.get(problemId) ?? [];\n      definitionPaths.push(relative(rootDirectoryPath, join(directoryPath, dirent.name)));\n      definitionPathsById.set(problemId, definitionPaths);\n    } else if (dirent.isDirectory() && !isExcludedFromDiscovery(directoryPath, dirent.name)) {\n      await collectProblemDefinitionsInto(rootDirectoryPath, join(directoryPath, dirent.name), definitionPathsById);\n    }\n  }\n}\n\n// The judge's discovery glob skips dot directories and these excludes.\nfunction isExcludedFromDiscovery(parentDirectoryPath: string, directoryName: string): boolean {\n  return (\n    directoryName.startsWith('.') ||\n    directoryName === 'node_modules' ||\n    directoryName === 'target' ||\n    (directoryName === 'temp' && basename(parentDirectoryPath) === 'judge-environments')\n  );\n}\n\n/**\n * Reports discovered problem definitions the judge refuses: an ID that does not match the ID pattern\n * aborts discovery of the whole repository, and an ID defined more than once is a conflict.\n */\nexport function reportProblemDefinitionIssues(\n  definitionPathsById: ReadonlyMap<string, string[]>,\n  errors: string[]\n): void {\n  for (const [problemId, definitionPaths] of definitionPathsById) {\n    if (!LEARNING_MATERIAL_ID_REGEX.test(problemId)) {\n      errors.push(\n        `problem ID \"${problemId}\" (${definitionPaths.join(', ')}) must match ${LEARNING_MATERIAL_ID_REGEX}; the judge aborts discovery on it`\n      );\n    }\n    if (definitionPaths.length > 1) {\n      errors.push(\n        `problem ID \"${problemId}\" is defined more than once (${definitionPaths.join(', ')}); the judge rejects the conflict`\n      );\n    }\n  }\n}\n\n/** Reports a problems directory the judge cannot search (missing, or a symbolic link); returns whether it is usable. */\nexport async function isUsableProblemsDirectory(problemsDirectoryPath: string, errors: string[]): Promise<boolean> {\n  if (await isRegularDirectory(problemsDirectoryPath)) return true;\n  errors.push(\n    (await isDirectory(problemsDirectoryPath))\n      ? `problems directory is a symbolic link, which the judge does not traverse: ${problemsDirectoryPath}`\n      : `problems directory not found: ${problemsDirectoryPath}`\n  );\n  return false;\n}\n\n/** Collects the problem IDs a directory defines, reporting the issues the judge refuses; undefined when it cannot be searched. */\nexport async function collectProblemIdsFromDirectory(\n  problemsDirectoryPath: string,\n  errors: string[]\n): Promise<Set<string> | undefined> {\n  if (!(await isUsableProblemsDirectory(problemsDirectoryPath, errors))) return undefined;\n  const definitionPathsById = await collectProblemDefinitions(problemsDirectoryPath);\n  reportProblemDefinitionIssues(definitionPathsById, errors);\n  return new Set(definitionPathsById.keys());\n}\n\nexport function reportDanglingProblemReferences(\n  problemIds: Iterable<string>,\n  availableProblemIds: ReadonlySet<string>,\n  problemsDirectoryPath: string | undefined,\n  errors: string[]\n): void {\n  const location = problemsDirectoryPath === undefined ? '' : ` under ${problemsDirectoryPath}`;\n  for (const problemId of new Set(problemIds)) {\n    if (!availableProblemIds.has(problemId)) {\n      errors.push(`problem \"${problemId}\" is referenced but does not exist${location}`);\n    }\n  }\n}\n\n/** Reads all text files under a directory, with paths relative to the given root. */\nexport async function readSourceFilesRecursively(rootDirectoryPath: string): Promise<SourceFile[]> {\n  const files: SourceFile[] = [];\n  await collectSourceFiles(rootDirectoryPath, rootDirectoryPath, files);\n  return files.toSorted((f1, f2) => f1.path.localeCompare(f2.path));\n}\n\nasync function collectSourceFiles(\n  rootDirectoryPath: string,\n  directoryPath: string,\n  files: SourceFile[]\n): Promise<void> {\n  for (const dirent of await readdir(directoryPath, { withFileTypes: true })) {\n    const entryPath = join(directoryPath, dirent.name);\n    if (dirent.isDirectory()) {\n      if (!IGNORED_DIRECTORY_NAMES.has(dirent.name)) {\n        await collectSourceFiles(rootDirectoryPath, entryPath, files);\n      }\n    } else if (dirent.isFile() && !NON_CODE_EXTENSIONS.has(extname(dirent.name).toLowerCase())) {\n      files.push({ path: relative(rootDirectoryPath, entryPath), data: await readFile(entryPath, 'utf8') });\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/learningMaterial/fsHelpers.js

@@ -1,2 +1,2 @@
-import{LEARNING_MATERIAL_ID_REGEX as e}from"./schemas.js";import{basename as t,extname as n,join as r,relative as i}from"node:path";import{lstat as a,readFile as o,readdir as s,stat as c}from"node:fs/promises";const l=new Set([`__pycache__`]),u=new Set([``,`.class`,`.exe`,`.jar`,`.out`,`.pyc`,`.png`,`.gif`]);async function d(e){try{return(await c(e)).isFile()}catch{return!1}}async function f(e){try{return(await a(e)).isFile()}catch{return!1}}async function p(e){try{return(await a(e)).isDirectory()}catch{return!1}}async function m(e){try{return(await c(e)).isDirectory()}catch{return!1}}async function h(e){let t=new Map;return await g(e,e,t),t}async function g(e,n,a){let o=await s(n,{withFileTypes:!0});if(!(n!==e&&o.some(e=>e.isFile()&&(e.name===`course.yaml`||e.name===`course.yml`))))for(let s of o)if(s.isFile()){let o=s.name===`problem.md`?t(n):s.name.endsWith(`.problem.md`)?s.name.slice(0,-11).toLowerCase():void 0;if(o===void 0)continue;let c=a.get(o)??[];c.push(i(e,r(n,s.name))),a.set(o,c)}else s.isDirectory()&&!_(n,s.name)&&await g(e,r(n,s.name),a)}function _(e,n){return n.startsWith(`.`)||n===`node_modules`||n===`target`||n===`temp`&&t(e)===`judge-environments`}function v(t,n){for(let[r,i]of t)e.test(r)||n.push(`problem ID "${r}" (${i.join(`, `)}) must match ${e}; the judge aborts discovery on it`),i.length>1&&n.push(`problem ID "${r}" is defined more than once (${i.join(`, `)}); the judge rejects the conflict`)}async function y(e,t){return await p(e)?!0:(t.push(await m(e)?`problems directory is a symbolic link, which the judge does not traverse: ${e}`:`problems directory not found: ${e}`),!1)}async function b(e,t){if(!await y(e,t))return;let n=await h(e);return v(n,t),new Set(n.keys())}function x(e,t,n,r){let i=n===void 0?``:` under ${n}`;for(let n of new Set(e))t.has(n)||r.push(`problem "${n}" is referenced but does not exist${i}`)}async function S(e){let t=[];return await C(e,e,t),t.toSorted((e,t)=>e.path.localeCompare(t.path))}async function C(e,t,a){for(let c of await s(t,{withFileTypes:!0})){let s=r(t,c.name);c.isDirectory()?l.has(c.name)||await C(e,s,a):c.isFile()&&!u.has(n(c.name).toLowerCase())&&a.push({path:i(e,s),data:await o(s,`utf8`)})}}export{h as collectProblemDefinitions,b as collectProblemIdsFromDirectory,m as isDirectory,d as isFile,p as isRegularDirectory,f as isRegularFile,y as isUsableProblemsDirectory,S as readSourceFilesRecursively,x as reportDanglingProblemReferences,v as reportProblemDefinitionIssues};
+import{LEARNING_MATERIAL_ID_REGEX as e}from"./schemas.js";import{basename as t,extname as n,join as r,relative as i}from"node:path";import{lstat as a,readFile as o,readdir as s,stat as c}from"node:fs/promises";const l=/* @__PURE__ */ new Set([`__pycache__`]),u=/* @__PURE__ */ new Set([``,`.class`,`.exe`,`.jar`,`.out`,`.pyc`,`.png`,`.gif`]);async function d(e){try{return(await c(e)).isFile()}catch{return!1}}async function f(e){try{return(await a(e)).isFile()}catch{return!1}}async function p(e){try{return(await a(e)).isDirectory()}catch{return!1}}async function m(e){try{return(await c(e)).isDirectory()}catch{return!1}}async function h(e){let t=/* @__PURE__ */ new Map;return await g(e,e,t),t}async function g(e,n,a){let o=await s(n,{withFileTypes:!0});if(!(n!==e&&o.some(e=>e.isFile()&&(e.name===`course.yaml`||e.name===`course.yml`))))for(let s of o)if(s.isFile()){let o=s.name===`problem.md`?t(n):s.name.endsWith(`.problem.md`)?s.name.slice(0,-11).toLowerCase():void 0;if(o===void 0)continue;let c=a.get(o)??[];c.push(i(e,r(n,s.name))),a.set(o,c)}else s.isDirectory()&&!_(n,s.name)&&await g(e,r(n,s.name),a)}function _(e,n){return n.startsWith(`.`)||n===`node_modules`||n===`target`||n===`temp`&&t(e)===`judge-environments`}function v(t,n){for(let[r,i]of t)e.test(r)||n.push(`problem ID "${r}" (${i.join(`, `)}) must match ${e}; the judge aborts discovery on it`),i.length>1&&n.push(`problem ID "${r}" is defined more than once (${i.join(`, `)}); the judge rejects the conflict`)}async function y(e,t){return await p(e)?!0:(t.push(await m(e)?`problems directory is a symbolic link, which the judge does not traverse: ${e}`:`problems directory not found: ${e}`),!1)}async function b(e,t){if(!await y(e,t))return;let n=await h(e);return v(n,t),new Set(n.keys())}function x(e,t,n,r){let i=n===void 0?``:` under ${n}`;for(let n of new Set(e))t.has(n)||r.push(`problem "${n}" is referenced but does not exist${i}`)}async function S(e){let t=[];return await C(e,e,t),t.toSorted((e,t)=>e.path.localeCompare(t.path))}async function C(e,t,a){for(let c of await s(t,{withFileTypes:!0})){let s=r(t,c.name);c.isDirectory()?l.has(c.name)||await C(e,s,a):c.isFile()&&!u.has(n(c.name).toLowerCase())&&a.push({path:i(e,s),data:await o(s,`utf8`)})}}export{h as collectProblemDefinitions,b as collectProblemIdsFromDirectory,m as isDirectory,d as isFile,p as isRegularDirectory,f as isRegularFile,y as isUsableProblemsDirectory,S as readSourceFilesRecursively,x as reportDanglingProblemReferences,v as reportProblemDefinitionIssues};
 //# sourceMappingURL=fsHelpers.js.map

package/dist/learningMaterial/fsHelpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"fsHelpers.js","names":[],"sources":["../../src/learningMaterial/fsHelpers.ts"],"sourcesContent":["import { lstat, readdir, readFile, stat } from 'node:fs/promises';\nimport { basename, extname, join, relative } from 'node:path';\n\nimport { LEARNING_MATERIAL_ID_REGEX } from './schemas.js';\n\n// Files the judge importer skips when reading problem directories. The extension filter is ported\n// from the judge's readSourceCodeFilesInDirectory so compile artifacts (e.g. Main.class next to\n// Main.java) are excluded from pattern checks exactly like the judge excludes them at import time;\n// the '' entry also drops dot files such as `.DS_Store`, whose extension is ''.\nconst IGNORED_DIRECTORY_NAMES: ReadonlySet<string> = new Set(['__pycache__']);\nconst NON_CODE_EXTENSIONS: ReadonlySet<string> = new Set([\n  '',\n  '.class',\n  '.exe',\n  '.jar',\n  '.out',\n  '.pyc',\n  '.png',\n  '.gif',\n]);\n\nexport interface SourceFile {\n  path: string;\n  data: string;\n}\n\nexport async function isFile(path: string): Promise<boolean> {\n  try {\n    const stats = await stat(path);\n    return stats.isFile();\n  } catch {\n    return false;\n  }\n}\n\n/** Whether the path is a regular file (not a symlink), as the judge's problem discovery requires. */\nexport async function isRegularFile(path: string): Promise<boolean> {\n  try {\n    const stats = await lstat(path);\n    return stats.isFile();\n  } catch {\n    return false;\n  }\n}\n\n/** Whether the path is a directory that is not a symbolic link, which the judge's discovery does not traverse. */\nexport async function isRegularDirectory(path: string): Promise<boolean> {\n  try {\n    const stats = await lstat(path);\n    return stats.isDirectory();\n  } catch {\n    return false;\n  }\n}\n\nexport async function isDirectory(path: string): Promise<boolean> {\n  try {\n    const stats = await stat(path);\n    return stats.isDirectory();\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Collects the problem definitions under a directory the way the judge discovers them: `problem.md`\n * names its directory and `<id>.problem.md` names itself, at any depth, without traversing symbolic\n * links or a nested course (whose problems belong to that nearer course). The result maps each\n * problem ID to the paths of its definitions (relative to the root); the judge rejects an ID\n * defined more than once.\n */\nexport async function collectProblemDefinitions(rootDirectoryPath: string): Promise<Map<string, string[]>> {\n  const definitionPathsById = new Map<string, string[]>();\n  await collectProblemDefinitionsInto(rootDirectoryPath, rootDirectoryPath, definitionPathsById);\n  return definitionPathsById;\n}\n\nasync function collectProblemDefinitionsInto(\n  rootDirectoryPath: string,\n  directoryPath: string,\n  definitionPathsById: Map<string, string[]>\n): Promise<void> {\n  const dirents = await readdir(directoryPath, { withFileTypes: true });\n  if (\n    directoryPath !== rootDirectoryPath &&\n    dirents.some((dirent) => dirent.isFile() && (dirent.name === 'course.yaml' || dirent.name === 'course.yml'))\n  ) {\n    return;\n  }\n  for (const dirent of dirents) {\n    if (dirent.isFile()) {\n      const problemId =\n        dirent.name === 'problem.md'\n          ? basename(directoryPath)\n          : dirent.name.endsWith('.problem.md')\n            ? // The judge lowercases a v1 file name before using it as the ID (a directory name is used as is).\n              dirent.name.slice(0, -'.problem.md'.length).toLowerCase()\n            : undefined;\n      if (problemId === undefined) continue;\n      const definitionPaths = definitionPathsById.get(problemId) ?? [];\n      definitionPaths.push(relative(rootDirectoryPath, join(directoryPath, dirent.name)));\n      definitionPathsById.set(problemId, definitionPaths);\n    } else if (dirent.isDirectory() && !isExcludedFromDiscovery(directoryPath, dirent.name)) {\n      await collectProblemDefinitionsInto(rootDirectoryPath, join(directoryPath, dirent.name), definitionPathsById);\n    }\n  }\n}\n\n// The judge's discovery glob skips dot directories and these excludes.\nfunction isExcludedFromDiscovery(parentDirectoryPath: string, directoryName: string): boolean {\n  return (\n    directoryName.startsWith('.') ||\n    directoryName === 'node_modules' ||\n    directoryName === 'target' ||\n    (directoryName === 'temp' && basename(parentDirectoryPath) === 'judge-environments')\n  );\n}\n\n/**\n * Reports discovered problem definitions the judge refuses: an ID that does not match the ID pattern\n * aborts discovery of the whole repository, and an ID defined more than once is a conflict.\n */\nexport function reportProblemDefinitionIssues(\n  definitionPathsById: ReadonlyMap<string, string[]>,\n  errors: string[]\n): void {\n  for (const [problemId, definitionPaths] of definitionPathsById) {\n    if (!LEARNING_MATERIAL_ID_REGEX.test(problemId)) {\n      errors.push(\n        `problem ID \"${problemId}\" (${definitionPaths.join(', ')}) must match ${LEARNING_MATERIAL_ID_REGEX}; the judge aborts discovery on it`\n      );\n    }\n    if (definitionPaths.length > 1) {\n      errors.push(\n        `problem ID \"${problemId}\" is defined more than once (${definitionPaths.join(', ')}); the judge rejects the conflict`\n      );\n    }\n  }\n}\n\n/** Reports a problems directory the judge cannot search (missing, or a symbolic link); returns whether it is usable. */\nexport async function isUsableProblemsDirectory(problemsDirectoryPath: string, errors: string[]): Promise<boolean> {\n  if (await isRegularDirectory(problemsDirectoryPath)) return true;\n  errors.push(\n    (await isDirectory(problemsDirectoryPath))\n      ? `problems directory is a symbolic link, which the judge does not traverse: ${problemsDirectoryPath}`\n      : `problems directory not found: ${problemsDirectoryPath}`\n  );\n  return false;\n}\n\n/** Collects the problem IDs a directory defines, reporting the issues the judge refuses; undefined when it cannot be searched. */\nexport async function collectProblemIdsFromDirectory(\n  problemsDirectoryPath: string,\n  errors: string[]\n): Promise<Set<string> | undefined> {\n  if (!(await isUsableProblemsDirectory(problemsDirectoryPath, errors))) return undefined;\n  const definitionPathsById = await collectProblemDefinitions(problemsDirectoryPath);\n  reportProblemDefinitionIssues(definitionPathsById, errors);\n  return new Set(definitionPathsById.keys());\n}\n\nexport function reportDanglingProblemReferences(\n  problemIds: Iterable<string>,\n  availableProblemIds: ReadonlySet<string>,\n  problemsDirectoryPath: string | undefined,\n  errors: string[]\n): void {\n  const location = problemsDirectoryPath === undefined ? '' : ` under ${problemsDirectoryPath}`;\n  for (const problemId of new Set(problemIds)) {\n    if (!availableProblemIds.has(problemId)) {\n      errors.push(`problem \"${problemId}\" is referenced but does not exist${location}`);\n    }\n  }\n}\n\n/** Reads all text files under a directory, with paths relative to the given root. */\nexport async function readSourceFilesRecursively(rootDirectoryPath: string): Promise<SourceFile[]> {\n  const files: SourceFile[] = [];\n  await collectSourceFiles(rootDirectoryPath, rootDirectoryPath, files);\n  return files.toSorted((f1, f2) => f1.path.localeCompare(f2.path));\n}\n\nasync function collectSourceFiles(\n  rootDirectoryPath: string,\n  directoryPath: string,\n  files: SourceFile[]\n): Promise<void> {\n  for (const dirent of await readdir(directoryPath, { withFileTypes: true })) {\n    const entryPath = join(directoryPath, dirent.name);\n    if (dirent.isDirectory()) {\n      if (!IGNORED_DIRECTORY_NAMES.has(dirent.name)) {\n        await collectSourceFiles(rootDirectoryPath, entryPath, files);\n      }\n    } else if (dirent.isFile() && !NON_CODE_EXTENSIONS.has(extname(dirent.name).toLowerCase())) {\n      files.push({ path: relative(rootDirectoryPath, entryPath), data: await readFile(entryPath, 'utf8') });\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"fsHelpers.js","names":[],"sources":["../../src/learningMaterial/fsHelpers.ts"],"sourcesContent":["import { lstat, readdir, readFile, stat } from 'node:fs/promises';\nimport { basename, extname, join, relative } from 'node:path';\n\nimport { LEARNING_MATERIAL_ID_REGEX } from './schemas.js';\n\n// Files the judge importer skips when reading problem directories. The extension filter is ported\n// from the judge's readSourceCodeFilesInDirectory so compile artifacts (e.g. Main.class next to\n// Main.java) are excluded from pattern checks exactly like the judge excludes them at import time;\n// the '' entry also drops dot files such as `.DS_Store`, whose extension is ''.\nconst IGNORED_DIRECTORY_NAMES: ReadonlySet<string> = new Set(['__pycache__']);\nconst NON_CODE_EXTENSIONS: ReadonlySet<string> = new Set([\n  '',\n  '.class',\n  '.exe',\n  '.jar',\n  '.out',\n  '.pyc',\n  '.png',\n  '.gif',\n]);\n\nexport interface SourceFile {\n  path: string;\n  data: string;\n}\n\nexport async function isFile(path: string): Promise<boolean> {\n  try {\n    const stats = await stat(path);\n    return stats.isFile();\n  } catch {\n    return false;\n  }\n}\n\n/** Whether the path is a regular file (not a symlink), as the judge's problem discovery requires. */\nexport async function isRegularFile(path: string): Promise<boolean> {\n  try {\n    const stats = await lstat(path);\n    return stats.isFile();\n  } catch {\n    return false;\n  }\n}\n\n/** Whether the path is a directory that is not a symbolic link, which the judge's discovery does not traverse. */\nexport async function isRegularDirectory(path: string): Promise<boolean> {\n  try {\n    const stats = await lstat(path);\n    return stats.isDirectory();\n  } catch {\n    return false;\n  }\n}\n\nexport async function isDirectory(path: string): Promise<boolean> {\n  try {\n    const stats = await stat(path);\n    return stats.isDirectory();\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Collects the problem definitions under a directory the way the judge discovers them: `problem.md`\n * names its directory and `<id>.problem.md` names itself, at any depth, without traversing symbolic\n * links or a nested course (whose problems belong to that nearer course). The result maps each\n * problem ID to the paths of its definitions (relative to the root); the judge rejects an ID\n * defined more than once.\n */\nexport async function collectProblemDefinitions(rootDirectoryPath: string): Promise<Map<string, string[]>> {\n  const definitionPathsById = new Map<string, string[]>();\n  await collectProblemDefinitionsInto(rootDirectoryPath, rootDirectoryPath, definitionPathsById);\n  return definitionPathsById;\n}\n\nasync function collectProblemDefinitionsInto(\n  rootDirectoryPath: string,\n  directoryPath: string,\n  definitionPathsById: Map<string, string[]>\n): Promise<void> {\n  const dirents = await readdir(directoryPath, { withFileTypes: true });\n  if (\n    directoryPath !== rootDirectoryPath &&\n    dirents.some((dirent) => dirent.isFile() && (dirent.name === 'course.yaml' || dirent.name === 'course.yml'))\n  ) {\n    return;\n  }\n  for (const dirent of dirents) {\n    if (dirent.isFile()) {\n      const problemId =\n        dirent.name === 'problem.md'\n          ? basename(directoryPath)\n          : dirent.name.endsWith('.problem.md')\n            ? // The judge lowercases a v1 file name before using it as the ID (a directory name is used as is).\n              dirent.name.slice(0, -'.problem.md'.length).toLowerCase()\n            : undefined;\n      if (problemId === undefined) continue;\n      const definitionPaths = definitionPathsById.get(problemId) ?? [];\n      definitionPaths.push(relative(rootDirectoryPath, join(directoryPath, dirent.name)));\n      definitionPathsById.set(problemId, definitionPaths);\n    } else if (dirent.isDirectory() && !isExcludedFromDiscovery(directoryPath, dirent.name)) {\n      await collectProblemDefinitionsInto(rootDirectoryPath, join(directoryPath, dirent.name), definitionPathsById);\n    }\n  }\n}\n\n// The judge's discovery glob skips dot directories and these excludes.\nfunction isExcludedFromDiscovery(parentDirectoryPath: string, directoryName: string): boolean {\n  return (\n    directoryName.startsWith('.') ||\n    directoryName === 'node_modules' ||\n    directoryName === 'target' ||\n    (directoryName === 'temp' && basename(parentDirectoryPath) === 'judge-environments')\n  );\n}\n\n/**\n * Reports discovered problem definitions the judge refuses: an ID that does not match the ID pattern\n * aborts discovery of the whole repository, and an ID defined more than once is a conflict.\n */\nexport function reportProblemDefinitionIssues(\n  definitionPathsById: ReadonlyMap<string, string[]>,\n  errors: string[]\n): void {\n  for (const [problemId, definitionPaths] of definitionPathsById) {\n    if (!LEARNING_MATERIAL_ID_REGEX.test(problemId)) {\n      errors.push(\n        `problem ID \"${problemId}\" (${definitionPaths.join(', ')}) must match ${LEARNING_MATERIAL_ID_REGEX}; the judge aborts discovery on it`\n      );\n    }\n    if (definitionPaths.length > 1) {\n      errors.push(\n        `problem ID \"${problemId}\" is defined more than once (${definitionPaths.join(', ')}); the judge rejects the conflict`\n      );\n    }\n  }\n}\n\n/** Reports a problems directory the judge cannot search (missing, or a symbolic link); returns whether it is usable. */\nexport async function isUsableProblemsDirectory(problemsDirectoryPath: string, errors: string[]): Promise<boolean> {\n  if (await isRegularDirectory(problemsDirectoryPath)) return true;\n  errors.push(\n    (await isDirectory(problemsDirectoryPath))\n      ? `problems directory is a symbolic link, which the judge does not traverse: ${problemsDirectoryPath}`\n      : `problems directory not found: ${problemsDirectoryPath}`\n  );\n  return false;\n}\n\n/** Collects the problem IDs a directory defines, reporting the issues the judge refuses; undefined when it cannot be searched. */\nexport async function collectProblemIdsFromDirectory(\n  problemsDirectoryPath: string,\n  errors: string[]\n): Promise<Set<string> | undefined> {\n  if (!(await isUsableProblemsDirectory(problemsDirectoryPath, errors))) return undefined;\n  const definitionPathsById = await collectProblemDefinitions(problemsDirectoryPath);\n  reportProblemDefinitionIssues(definitionPathsById, errors);\n  return new Set(definitionPathsById.keys());\n}\n\nexport function reportDanglingProblemReferences(\n  problemIds: Iterable<string>,\n  availableProblemIds: ReadonlySet<string>,\n  problemsDirectoryPath: string | undefined,\n  errors: string[]\n): void {\n  const location = problemsDirectoryPath === undefined ? '' : ` under ${problemsDirectoryPath}`;\n  for (const problemId of new Set(problemIds)) {\n    if (!availableProblemIds.has(problemId)) {\n      errors.push(`problem \"${problemId}\" is referenced but does not exist${location}`);\n    }\n  }\n}\n\n/** Reads all text files under a directory, with paths relative to the given root. */\nexport async function readSourceFilesRecursively(rootDirectoryPath: string): Promise<SourceFile[]> {\n  const files: SourceFile[] = [];\n  await collectSourceFiles(rootDirectoryPath, rootDirectoryPath, files);\n  return files.toSorted((f1, f2) => f1.path.localeCompare(f2.path));\n}\n\nasync function collectSourceFiles(\n  rootDirectoryPath: string,\n  directoryPath: string,\n  files: SourceFile[]\n): Promise<void> {\n  for (const dirent of await readdir(directoryPath, { withFileTypes: true })) {\n    const entryPath = join(directoryPath, dirent.name);\n    if (dirent.isDirectory()) {\n      if (!IGNORED_DIRECTORY_NAMES.has(dirent.name)) {\n        await collectSourceFiles(rootDirectoryPath, entryPath, files);\n      }\n    } else if (dirent.isFile() && !NON_CODE_EXTENSIONS.has(extname(dirent.name).toLowerCase())) {\n      files.push({ path: relative(rootDirectoryPath, entryPath), data: await readFile(entryPath, 'utf8') });\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/learningMaterial/validateContest.cjs

@@ -1,2 +1,2 @@
-"use strict";const e=require("./schemas.cjs"),t=require("./fsHelpers.cjs"),n=require("./validationResult.cjs"),r=require("./validateMaterial.cjs");let i=require("node:path"),a=require("node:fs/promises"),o=require("yaml");async function s(s,c={}){let l=[],u=[],d={errors:l,warnings:u};if(!await t.isRegularFile(s))return l.push(await t.isFile(s)?`contest file is a symbolic link, which the judge ignores; commit a regular file: ${s}`:`contest file not found: ${s}`),d;let f=(0,i.basename)(s);if(!f.endsWith(`.contest.yaml`))return l.push(`contest file name must end with ${e.CONTEST_MATERIAL_FILE_SUFFIX}: ${f}`),d;let p=f.slice(0,-e.CONTEST_MATERIAL_FILE_SUFFIX.length);e.LEARNING_MATERIAL_ID_REGEX.test(p)||l.push(`contest ID "${p}" (file name without ${e.CONTEST_MATERIAL_FILE_SUFFIX}) must match ${e.LEARNING_MATERIAL_ID_REGEX}`);let m;try{m=(0,o.parse)(await(0,a.readFile)(s,`utf8`))}catch(e){return l.push(`invalid YAML: ${e instanceof Error?e.message:String(e)}`),d}let h=e.contestFileSchema.safeParse(m);if(!h.success)return l.push(...n.formatZodIssues(h.error,`contest`)),d;r.validateSubmissionPeriods(r.mergeSubmissionPeriods(h.data,c.courseSubmissionPeriods),l,h.data),r.reportForeignProblemCourseIds(h.data.problems,c.courseId,l),n.reportDuplicateIds(h.data.divisions.map(e=>e.id),`division`,l),n.reportDuplicateIds(h.data.problems.map(e=>e.id),`problem`,l);let g=c.availableProblemIds;return g===void 0&&(c.problemsDirectoryPath===void 0?c.isNestedInCourse||u.push(`no problems directory given (pass --problems-dir); problem references are not checked`):g=await t.collectProblemIdsFromDirectory(c.problemsDirectoryPath,l)),g!==void 0&&t.reportDanglingProblemReferences(h.data.problems.map(e=>e.id),g,c.problemsDirectoryPath,l),d}exports.validateContestFile=s;
+"use strict";const e=require("./schemas.cjs"),t=require("./fsHelpers.cjs"),n=require("./validationResult.cjs"),r=require("./validateMaterial.cjs");let i=require("node:path"),a=require("node:fs/promises"),o=require("@willbooster/shared-lib"),s=require("yaml");async function c(c,l={}){let u=[],d=[],f={errors:u,warnings:d};if(!await t.isRegularFile(c))return u.push(await t.isFile(c)?`contest file is a symbolic link, which the judge ignores; commit a regular file: ${c}`:`contest file not found: ${c}`),f;let p=(0,i.basename)(c);if(!p.endsWith(`.contest.yaml`))return u.push(`contest file name must end with ${e.CONTEST_MATERIAL_FILE_SUFFIX}: ${p}`),f;let m=p.slice(0,-e.CONTEST_MATERIAL_FILE_SUFFIX.length);e.LEARNING_MATERIAL_ID_REGEX.test(m)||u.push(`contest ID "${m}" (file name without ${e.CONTEST_MATERIAL_FILE_SUFFIX}) must match ${e.LEARNING_MATERIAL_ID_REGEX}`);let h;try{h=(0,s.parse)(await(0,a.readFile)(c,`utf8`))}catch(e){return u.push(`invalid YAML: ${(0,o.getErrorMessage)(e)}`),f}let g=e.contestFileSchema.safeParse(h);if(!g.success)return u.push(...n.formatZodIssues(g.error,`contest`)),f;r.validateSubmissionPeriods(r.mergeSubmissionPeriods(g.data,l.courseSubmissionPeriods),u,g.data),r.reportForeignProblemCourseIds(g.data.problems,l.courseId,u),n.reportDuplicateIds(g.data.divisions.map(e=>e.id),`division`,u),n.reportDuplicateIds(g.data.problems.map(e=>e.id),`problem`,u);let _=l.availableProblemIds;return _===void 0&&(l.problemsDirectoryPath===void 0?l.isNestedInCourse||d.push(`no problems directory given (pass --problems-dir); problem references are not checked`):_=await t.collectProblemIdsFromDirectory(l.problemsDirectoryPath,u)),_!==void 0&&t.reportDanglingProblemReferences(g.data.problems.map(e=>e.id),_,l.problemsDirectoryPath,u),f}exports.validateContestFile=c;
 //# sourceMappingURL=validateContest.cjs.map

package/dist/learningMaterial/validateContest.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"validateContest.cjs","names":["isRegularFile","isFile","basename","CONTEST_MATERIAL_FILE_SUFFIX","LEARNING_MATERIAL_ID_REGEX","parseYaml","readFile","contestFileSchema","formatZodIssues","mergeSubmissionPeriods","collectProblemIdsFromDirectory"],"sources":["../../src/learningMaterial/validateContest.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { basename } from 'node:path';\nimport { parse as parseYaml } from 'yaml';\nimport { collectProblemIdsFromDirectory, isFile, isRegularFile, reportDanglingProblemReferences } from './fsHelpers.js';\nimport { CONTEST_MATERIAL_FILE_SUFFIX, contestFileSchema, LEARNING_MATERIAL_ID_REGEX } from './schemas.js';\nimport {\n  mergeSubmissionPeriods,\n  reportForeignProblemCourseIds,\n  validateSubmissionPeriods,\n  type SubmissionPeriods,\n} from './validateMaterial.js';\nimport { formatZodIssues, reportDuplicateIds, type ValidationResult } from './validationResult.js';\n\nexport interface ContestValidationOptions {\n  /** When set, every contest problem ID must be a problem discovered under this path. */\n  problemsDirectoryPath?: string;\n  /** Problem IDs already collected for the enclosing course; collected from `problemsDirectoryPath` otherwise. */\n  availableProblemIds?: ReadonlySet<string>;\n  /** Enclosing course ID; the judge rejects problem references whose `courseId` differs from it. */\n  courseId?: string;\n  /** Course-level submission periods; the judge merges them as `material[field] ?? course[field]`. */\n  courseSubmissionPeriods?: SubmissionPeriods;\n  /** Set by course validation, which already warns once about a missing problems directory. */\n  isNestedInCourse?: boolean;\n}\n\n/** Validates a judge contest material (`*.contest.yaml`) file. */\nexport async function validateContestFile(\n  contestFilePath: string,\n  options: ContestValidationOptions = {}\n): Promise<ValidationResult> {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n  const result = { errors, warnings };\n\n  // The judge lists lecture entries as regular files, so a symbolic link is skipped at import time.\n  if (!(await isRegularFile(contestFilePath))) {\n    errors.push(\n      (await isFile(contestFilePath))\n        ? `contest file is a symbolic link, which the judge ignores; commit a regular file: ${contestFilePath}`\n        : `contest file not found: ${contestFilePath}`\n    );\n    return result;\n  }\n  const fileName = basename(contestFilePath);\n  if (!fileName.endsWith(CONTEST_MATERIAL_FILE_SUFFIX)) {\n    errors.push(`contest file name must end with ${CONTEST_MATERIAL_FILE_SUFFIX}: ${fileName}`);\n    return result;\n  }\n  const contestId = fileName.slice(0, -CONTEST_MATERIAL_FILE_SUFFIX.length);\n  if (!LEARNING_MATERIAL_ID_REGEX.test(contestId)) {\n    errors.push(\n      `contest ID \"${contestId}\" (file name without ${CONTEST_MATERIAL_FILE_SUFFIX}) must match ${LEARNING_MATERIAL_ID_REGEX}`\n    );\n  }\n\n  let rawContent: unknown;\n  try {\n    rawContent = parseYaml(await readFile(contestFilePath, 'utf8'));\n  } catch (error) {\n    errors.push(`invalid YAML: ${error instanceof Error ? error.message : String(error)}`);\n    return result;\n  }\n  const parsed = contestFileSchema.safeParse(rawContent);\n  if (!parsed.success) {\n    errors.push(...formatZodIssues(parsed.error, 'contest'));\n    return result;\n  }\n\n  validateSubmissionPeriods(mergeSubmissionPeriods(parsed.data, options.courseSubmissionPeriods), errors, parsed.data);\n  reportForeignProblemCourseIds(parsed.data.problems, options.courseId, errors);\n  reportDuplicateIds(\n    parsed.data.divisions.map((division) => division.id),\n    'division',\n    errors\n  );\n  reportDuplicateIds(\n    parsed.data.problems.map((problem) => problem.id),\n    'problem',\n    errors\n  );\n\n  let availableProblemIds = options.availableProblemIds;\n  if (availableProblemIds === undefined) {\n    if (options.problemsDirectoryPath === undefined) {\n      if (!options.isNestedInCourse) {\n        warnings.push('no problems directory given (pass --problems-dir); problem references are not checked');\n      }\n    } else {\n      availableProblemIds = await collectProblemIdsFromDirectory(options.problemsDirectoryPath, errors);\n    }\n  }\n  if (availableProblemIds !== undefined) {\n    reportDanglingProblemReferences(\n      parsed.data.problems.map((problem) => problem.id),\n      availableProblemIds,\n      options.problemsDirectoryPath,\n      errors\n    );\n  }\n  return result;\n}\n"],"mappings":"8NA2BA,eAAsB,EACpB,EACA,EAAoC,CAAC,EACV,CAC3B,IAAM,EAAmB,CAAC,EACpB,EAAqB,CAAC,EACtB,EAAS,CAAE,SAAQ,UAAS,EAGlC,GAAI,CAAE,MAAMA,EAAAA,cAAc,CAAe,EAMvC,OALA,EAAO,KACJ,MAAMC,EAAAA,OAAO,CAAe,EACzB,oFAAoF,IACpF,2BAA2B,GACjC,EACO,EAET,IAAM,GAAA,EAAWC,EAAAA,SAAAA,CAAS,CAAe,EACzC,GAAI,CAAC,EAAS,SAAA,eAAqC,EAEjD,OADA,EAAO,KAAK,mCAAmCC,EAAAA,6BAA6B,IAAI,GAAU,EACnF,EAET,IAAM,EAAY,EAAS,MAAM,EAAG,CAACA,EAAAA,6BAA6B,MAAM,EACnEC,EAAAA,2BAA2B,KAAK,CAAS,GAC5C,EAAO,KACL,eAAe,EAAU,uBAAuBD,EAAAA,6BAA6B,eAAeC,EAAAA,4BAC9F,EAGF,IAAI,EACJ,GAAI,CACF,GAAA,EAAaC,EAAAA,MAAAA,CAAU,MAAA,EAAMC,EAAAA,SAAAA,CAAS,EAAiB,MAAM,CAAC,CAChE,OAAS,EAAO,CAEd,OADA,EAAO,KAAK,iBAAiB,aAAiB,MAAQ,EAAM,QAAU,OAAO,CAAK,GAAG,EAC9E,CACT,CACA,IAAM,EAASC,EAAAA,kBAAkB,UAAU,CAAU,EACrD,GAAI,CAAC,EAAO,QAEV,OADA,EAAO,KAAK,GAAGC,EAAAA,gBAAgB,EAAO,MAAO,SAAS,CAAC,EAChD,EAGT,EAAA,0BAA0BC,EAAAA,uBAAuB,EAAO,KAAM,EAAQ,uBAAuB,EAAG,EAAQ,EAAO,IAAI,EACnH,EAAA,8BAA8B,EAAO,KAAK,SAAU,EAAQ,SAAU,CAAM,EAC5E,EAAA,mBACE,EAAO,KAAK,UAAU,IAAK,GAAa,EAAS,EAAE,EACnD,WACA,CACF,EACA,EAAA,mBACE,EAAO,KAAK,SAAS,IAAK,GAAY,EAAQ,EAAE,EAChD,UACA,CACF,EAEA,IAAI,EAAsB,EAAQ,oBAkBlC,OAjBI,IAAwB,IAAA,KACtB,EAAQ,wBAA0B,IAAA,GAC/B,EAAQ,kBACX,EAAS,KAAK,uFAAuF,EAGvG,EAAsB,MAAMC,EAAAA,+BAA+B,EAAQ,sBAAuB,CAAM,GAGhG,IAAwB,IAAA,IAC1B,EAAA,gCACE,EAAO,KAAK,SAAS,IAAK,GAAY,EAAQ,EAAE,EAChD,EACA,EAAQ,sBACR,CACF,EAEK,CACT"}
+{"version":3,"file":"validateContest.cjs","names":["isRegularFile","isFile","basename","CONTEST_MATERIAL_FILE_SUFFIX","LEARNING_MATERIAL_ID_REGEX","parseYaml","readFile","getErrorMessage","contestFileSchema","formatZodIssues","mergeSubmissionPeriods","collectProblemIdsFromDirectory"],"sources":["../../src/learningMaterial/validateContest.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { basename } from 'node:path';\nimport { getErrorMessage } from '@willbooster/shared-lib';\nimport { parse as parseYaml } from 'yaml';\nimport { collectProblemIdsFromDirectory, isFile, isRegularFile, reportDanglingProblemReferences } from './fsHelpers.js';\nimport { CONTEST_MATERIAL_FILE_SUFFIX, contestFileSchema, LEARNING_MATERIAL_ID_REGEX } from './schemas.js';\nimport {\n  mergeSubmissionPeriods,\n  reportForeignProblemCourseIds,\n  validateSubmissionPeriods,\n  type SubmissionPeriods,\n} from './validateMaterial.js';\nimport { formatZodIssues, reportDuplicateIds, type ValidationResult } from './validationResult.js';\n\nexport interface ContestValidationOptions {\n  /** When set, every contest problem ID must be a problem discovered under this path. */\n  problemsDirectoryPath?: string;\n  /** Problem IDs already collected for the enclosing course; collected from `problemsDirectoryPath` otherwise. */\n  availableProblemIds?: ReadonlySet<string>;\n  /** Enclosing course ID; the judge rejects problem references whose `courseId` differs from it. */\n  courseId?: string;\n  /** Course-level submission periods; the judge merges them as `material[field] ?? course[field]`. */\n  courseSubmissionPeriods?: SubmissionPeriods;\n  /** Set by course validation, which already warns once about a missing problems directory. */\n  isNestedInCourse?: boolean;\n}\n\n/** Validates a judge contest material (`*.contest.yaml`) file. */\nexport async function validateContestFile(\n  contestFilePath: string,\n  options: ContestValidationOptions = {}\n): Promise<ValidationResult> {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n  const result = { errors, warnings };\n\n  // The judge lists lecture entries as regular files, so a symbolic link is skipped at import time.\n  if (!(await isRegularFile(contestFilePath))) {\n    errors.push(\n      (await isFile(contestFilePath))\n        ? `contest file is a symbolic link, which the judge ignores; commit a regular file: ${contestFilePath}`\n        : `contest file not found: ${contestFilePath}`\n    );\n    return result;\n  }\n  const fileName = basename(contestFilePath);\n  if (!fileName.endsWith(CONTEST_MATERIAL_FILE_SUFFIX)) {\n    errors.push(`contest file name must end with ${CONTEST_MATERIAL_FILE_SUFFIX}: ${fileName}`);\n    return result;\n  }\n  const contestId = fileName.slice(0, -CONTEST_MATERIAL_FILE_SUFFIX.length);\n  if (!LEARNING_MATERIAL_ID_REGEX.test(contestId)) {\n    errors.push(\n      `contest ID \"${contestId}\" (file name without ${CONTEST_MATERIAL_FILE_SUFFIX}) must match ${LEARNING_MATERIAL_ID_REGEX}`\n    );\n  }\n\n  let rawContent: unknown;\n  try {\n    rawContent = parseYaml(await readFile(contestFilePath, 'utf8'));\n  } catch (error) {\n    errors.push(`invalid YAML: ${getErrorMessage(error)}`);\n    return result;\n  }\n  const parsed = contestFileSchema.safeParse(rawContent);\n  if (!parsed.success) {\n    errors.push(...formatZodIssues(parsed.error, 'contest'));\n    return result;\n  }\n\n  validateSubmissionPeriods(mergeSubmissionPeriods(parsed.data, options.courseSubmissionPeriods), errors, parsed.data);\n  reportForeignProblemCourseIds(parsed.data.problems, options.courseId, errors);\n  reportDuplicateIds(\n    parsed.data.divisions.map((division) => division.id),\n    'division',\n    errors\n  );\n  reportDuplicateIds(\n    parsed.data.problems.map((problem) => problem.id),\n    'problem',\n    errors\n  );\n\n  let availableProblemIds = options.availableProblemIds;\n  if (availableProblemIds === undefined) {\n    if (options.problemsDirectoryPath === undefined) {\n      if (!options.isNestedInCourse) {\n        warnings.push('no problems directory given (pass --problems-dir); problem references are not checked');\n      }\n    } else {\n      availableProblemIds = await collectProblemIdsFromDirectory(options.problemsDirectoryPath, errors);\n    }\n  }\n  if (availableProblemIds !== undefined) {\n    reportDanglingProblemReferences(\n      parsed.data.problems.map((problem) => problem.id),\n      availableProblemIds,\n      options.problemsDirectoryPath,\n      errors\n    );\n  }\n  return result;\n}\n"],"mappings":"mQA4BA,eAAsB,EACpB,EACA,EAAoC,CAAC,EACV,CAC3B,IAAM,EAAmB,CAAC,EACpB,EAAqB,CAAC,EACtB,EAAS,CAAE,SAAQ,UAAS,EAGlC,GAAI,CAAE,MAAMA,EAAAA,cAAc,CAAe,EAMvC,OALA,EAAO,KACJ,MAAMC,EAAAA,OAAO,CAAe,EACzB,oFAAoF,IACpF,2BAA2B,GACjC,EACO,EAET,IAAM,GAAA,EAAWC,EAAAA,SAAAA,CAAS,CAAe,EACzC,GAAI,CAAC,EAAS,SAAA,eAAqC,EAEjD,OADA,EAAO,KAAK,mCAAmCC,EAAAA,6BAA6B,IAAI,GAAU,EACnF,EAET,IAAM,EAAY,EAAS,MAAM,EAAG,CAACA,EAAAA,6BAA6B,MAAM,EACnEC,EAAAA,2BAA2B,KAAK,CAAS,GAC5C,EAAO,KACL,eAAe,EAAU,uBAAuBD,EAAAA,6BAA6B,eAAeC,EAAAA,4BAC9F,EAGF,IAAI,EACJ,GAAI,CACF,GAAA,EAAaC,EAAAA,MAAAA,CAAU,MAAA,EAAMC,EAAAA,SAAAA,CAAS,EAAiB,MAAM,CAAC,CAChE,OAAS,EAAO,CAEd,OADA,EAAO,KAAK,kBAAA,EAAiBC,EAAAA,gBAAAA,CAAgB,CAAK,GAAG,EAC9C,CACT,CACA,IAAM,EAASC,EAAAA,kBAAkB,UAAU,CAAU,EACrD,GAAI,CAAC,EAAO,QAEV,OADA,EAAO,KAAK,GAAGC,EAAAA,gBAAgB,EAAO,MAAO,SAAS,CAAC,EAChD,EAGT,EAAA,0BAA0BC,EAAAA,uBAAuB,EAAO,KAAM,EAAQ,uBAAuB,EAAG,EAAQ,EAAO,IAAI,EACnH,EAAA,8BAA8B,EAAO,KAAK,SAAU,EAAQ,SAAU,CAAM,EAC5E,EAAA,mBACE,EAAO,KAAK,UAAU,IAAK,GAAa,EAAS,EAAE,EACnD,WACA,CACF,EACA,EAAA,mBACE,EAAO,KAAK,SAAS,IAAK,GAAY,EAAQ,EAAE,EAChD,UACA,CACF,EAEA,IAAI,EAAsB,EAAQ,oBAkBlC,OAjBI,IAAwB,IAAA,KACtB,EAAQ,wBAA0B,IAAA,GAC/B,EAAQ,kBACX,EAAS,KAAK,uFAAuF,EAGvG,EAAsB,MAAMC,EAAAA,+BAA+B,EAAQ,sBAAuB,CAAM,GAGhG,IAAwB,IAAA,IAC1B,EAAA,gCACE,EAAO,KAAK,SAAS,IAAK,GAAY,EAAQ,EAAE,EAChD,EACA,EAAQ,sBACR,CACF,EAEK,CACT"}

package/dist/learningMaterial/validateContest.js

@@ -1,2 +1,2 @@
-import{CONTEST_MATERIAL_FILE_SUFFIX as e,LEARNING_MATERIAL_ID_REGEX as t,contestFileSchema as n}from"./schemas.js";import{collectProblemIdsFromDirectory as r,isFile as i,isRegularFile as a,reportDanglingProblemReferences as o}from"./fsHelpers.js";import{formatZodIssues as s,reportDuplicateIds as c}from"./validationResult.js";import{mergeSubmissionPeriods as l,reportForeignProblemCourseIds as u,validateSubmissionPeriods as d}from"./validateMaterial.js";import{basename as f}from"node:path";import{readFile as p}from"node:fs/promises";import{parse as m}from"yaml";async function h(h,g={}){let _=[],v=[],y={errors:_,warnings:v};if(!await a(h))return _.push(await i(h)?`contest file is a symbolic link, which the judge ignores; commit a regular file: ${h}`:`contest file not found: ${h}`),y;let b=f(h);if(!b.endsWith(`.contest.yaml`))return _.push(`contest file name must end with ${e}: ${b}`),y;let x=b.slice(0,-e.length);t.test(x)||_.push(`contest ID "${x}" (file name without ${e}) must match ${t}`);let S;try{S=m(await p(h,`utf8`))}catch(e){return _.push(`invalid YAML: ${e instanceof Error?e.message:String(e)}`),y}let C=n.safeParse(S);if(!C.success)return _.push(...s(C.error,`contest`)),y;d(l(C.data,g.courseSubmissionPeriods),_,C.data),u(C.data.problems,g.courseId,_),c(C.data.divisions.map(e=>e.id),`division`,_),c(C.data.problems.map(e=>e.id),`problem`,_);let w=g.availableProblemIds;return w===void 0&&(g.problemsDirectoryPath===void 0?g.isNestedInCourse||v.push(`no problems directory given (pass --problems-dir); problem references are not checked`):w=await r(g.problemsDirectoryPath,_)),w!==void 0&&o(C.data.problems.map(e=>e.id),w,g.problemsDirectoryPath,_),y}export{h as validateContestFile};
+import{CONTEST_MATERIAL_FILE_SUFFIX as e,LEARNING_MATERIAL_ID_REGEX as t,contestFileSchema as n}from"./schemas.js";import{collectProblemIdsFromDirectory as r,isFile as i,isRegularFile as a,reportDanglingProblemReferences as o}from"./fsHelpers.js";import{formatZodIssues as s,reportDuplicateIds as c}from"./validationResult.js";import{mergeSubmissionPeriods as l,reportForeignProblemCourseIds as u,validateSubmissionPeriods as d}from"./validateMaterial.js";import{basename as f}from"node:path";import{readFile as p}from"node:fs/promises";import{getErrorMessage as m}from"@willbooster/shared-lib";import{parse as h}from"yaml";async function g(g,_={}){let v=[],y=[],b={errors:v,warnings:y};if(!await a(g))return v.push(await i(g)?`contest file is a symbolic link, which the judge ignores; commit a regular file: ${g}`:`contest file not found: ${g}`),b;let x=f(g);if(!x.endsWith(`.contest.yaml`))return v.push(`contest file name must end with ${e}: ${x}`),b;let S=x.slice(0,-e.length);t.test(S)||v.push(`contest ID "${S}" (file name without ${e}) must match ${t}`);let C;try{C=h(await p(g,`utf8`))}catch(e){return v.push(`invalid YAML: ${m(e)}`),b}let w=n.safeParse(C);if(!w.success)return v.push(...s(w.error,`contest`)),b;d(l(w.data,_.courseSubmissionPeriods),v,w.data),u(w.data.problems,_.courseId,v),c(w.data.divisions.map(e=>e.id),`division`,v),c(w.data.problems.map(e=>e.id),`problem`,v);let T=_.availableProblemIds;return T===void 0&&(_.problemsDirectoryPath===void 0?_.isNestedInCourse||y.push(`no problems directory given (pass --problems-dir); problem references are not checked`):T=await r(_.problemsDirectoryPath,v)),T!==void 0&&o(w.data.problems.map(e=>e.id),T,_.problemsDirectoryPath,v),b}export{g as validateContestFile};
 //# sourceMappingURL=validateContest.js.map

package/dist/learningMaterial/validateContest.js.map

@@ -1 +1 @@
-{"version":3,"file":"validateContest.js","names":["parseYaml"],"sources":["../../src/learningMaterial/validateContest.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { basename } from 'node:path';\nimport { parse as parseYaml } from 'yaml';\nimport { collectProblemIdsFromDirectory, isFile, isRegularFile, reportDanglingProblemReferences } from './fsHelpers.js';\nimport { CONTEST_MATERIAL_FILE_SUFFIX, contestFileSchema, LEARNING_MATERIAL_ID_REGEX } from './schemas.js';\nimport {\n  mergeSubmissionPeriods,\n  reportForeignProblemCourseIds,\n  validateSubmissionPeriods,\n  type SubmissionPeriods,\n} from './validateMaterial.js';\nimport { formatZodIssues, reportDuplicateIds, type ValidationResult } from './validationResult.js';\n\nexport interface ContestValidationOptions {\n  /** When set, every contest problem ID must be a problem discovered under this path. */\n  problemsDirectoryPath?: string;\n  /** Problem IDs already collected for the enclosing course; collected from `problemsDirectoryPath` otherwise. */\n  availableProblemIds?: ReadonlySet<string>;\n  /** Enclosing course ID; the judge rejects problem references whose `courseId` differs from it. */\n  courseId?: string;\n  /** Course-level submission periods; the judge merges them as `material[field] ?? course[field]`. */\n  courseSubmissionPeriods?: SubmissionPeriods;\n  /** Set by course validation, which already warns once about a missing problems directory. */\n  isNestedInCourse?: boolean;\n}\n\n/** Validates a judge contest material (`*.contest.yaml`) file. */\nexport async function validateContestFile(\n  contestFilePath: string,\n  options: ContestValidationOptions = {}\n): Promise<ValidationResult> {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n  const result = { errors, warnings };\n\n  // The judge lists lecture entries as regular files, so a symbolic link is skipped at import time.\n  if (!(await isRegularFile(contestFilePath))) {\n    errors.push(\n      (await isFile(contestFilePath))\n        ? `contest file is a symbolic link, which the judge ignores; commit a regular file: ${contestFilePath}`\n        : `contest file not found: ${contestFilePath}`\n    );\n    return result;\n  }\n  const fileName = basename(contestFilePath);\n  if (!fileName.endsWith(CONTEST_MATERIAL_FILE_SUFFIX)) {\n    errors.push(`contest file name must end with ${CONTEST_MATERIAL_FILE_SUFFIX}: ${fileName}`);\n    return result;\n  }\n  const contestId = fileName.slice(0, -CONTEST_MATERIAL_FILE_SUFFIX.length);\n  if (!LEARNING_MATERIAL_ID_REGEX.test(contestId)) {\n    errors.push(\n      `contest ID \"${contestId}\" (file name without ${CONTEST_MATERIAL_FILE_SUFFIX}) must match ${LEARNING_MATERIAL_ID_REGEX}`\n    );\n  }\n\n  let rawContent: unknown;\n  try {\n    rawContent = parseYaml(await readFile(contestFilePath, 'utf8'));\n  } catch (error) {\n    errors.push(`invalid YAML: ${error instanceof Error ? error.message : String(error)}`);\n    return result;\n  }\n  const parsed = contestFileSchema.safeParse(rawContent);\n  if (!parsed.success) {\n    errors.push(...formatZodIssues(parsed.error, 'contest'));\n    return result;\n  }\n\n  validateSubmissionPeriods(mergeSubmissionPeriods(parsed.data, options.courseSubmissionPeriods), errors, parsed.data);\n  reportForeignProblemCourseIds(parsed.data.problems, options.courseId, errors);\n  reportDuplicateIds(\n    parsed.data.divisions.map((division) => division.id),\n    'division',\n    errors\n  );\n  reportDuplicateIds(\n    parsed.data.problems.map((problem) => problem.id),\n    'problem',\n    errors\n  );\n\n  let availableProblemIds = options.availableProblemIds;\n  if (availableProblemIds === undefined) {\n    if (options.problemsDirectoryPath === undefined) {\n      if (!options.isNestedInCourse) {\n        warnings.push('no problems directory given (pass --problems-dir); problem references are not checked');\n      }\n    } else {\n      availableProblemIds = await collectProblemIdsFromDirectory(options.problemsDirectoryPath, errors);\n    }\n  }\n  if (availableProblemIds !== undefined) {\n    reportDanglingProblemReferences(\n      parsed.data.problems.map((problem) => problem.id),\n      availableProblemIds,\n      options.problemsDirectoryPath,\n      errors\n    );\n  }\n  return result;\n}\n"],"mappings":"sjBA2BA,eAAsB,EACpB,EACA,EAAoC,CAAC,EACV,CAC3B,IAAM,EAAmB,CAAC,EACpB,EAAqB,CAAC,EACtB,EAAS,CAAE,SAAQ,UAAS,EAGlC,GAAI,CAAE,MAAM,EAAc,CAAe,EAMvC,OALA,EAAO,KACJ,MAAM,EAAO,CAAe,EACzB,oFAAoF,IACpF,2BAA2B,GACjC,EACO,EAET,IAAM,EAAW,EAAS,CAAe,EACzC,GAAI,CAAC,EAAS,SAAA,eAAqC,EAEjD,OADA,EAAO,KAAK,mCAAmC,EAA6B,IAAI,GAAU,EACnF,EAET,IAAM,EAAY,EAAS,MAAM,EAAG,CAAC,EAA6B,MAAM,EACnE,EAA2B,KAAK,CAAS,GAC5C,EAAO,KACL,eAAe,EAAU,uBAAuB,EAA6B,eAAe,GAC9F,EAGF,IAAI,EACJ,GAAI,CACF,EAAaA,EAAU,MAAM,EAAS,EAAiB,MAAM,CAAC,CAChE,OAAS,EAAO,CAEd,OADA,EAAO,KAAK,iBAAiB,aAAiB,MAAQ,EAAM,QAAU,OAAO,CAAK,GAAG,EAC9E,CACT,CACA,IAAM,EAAS,EAAkB,UAAU,CAAU,EACrD,GAAI,CAAC,EAAO,QAEV,OADA,EAAO,KAAK,GAAG,EAAgB,EAAO,MAAO,SAAS,CAAC,EAChD,EAGT,EAA0B,EAAuB,EAAO,KAAM,EAAQ,uBAAuB,EAAG,EAAQ,EAAO,IAAI,EACnH,EAA8B,EAAO,KAAK,SAAU,EAAQ,SAAU,CAAM,EAC5E,EACE,EAAO,KAAK,UAAU,IAAK,GAAa,EAAS,EAAE,EACnD,WACA,CACF,EACA,EACE,EAAO,KAAK,SAAS,IAAK,GAAY,EAAQ,EAAE,EAChD,UACA,CACF,EAEA,IAAI,EAAsB,EAAQ,oBAkBlC,OAjBI,IAAwB,IAAA,KACtB,EAAQ,wBAA0B,IAAA,GAC/B,EAAQ,kBACX,EAAS,KAAK,uFAAuF,EAGvG,EAAsB,MAAM,EAA+B,EAAQ,sBAAuB,CAAM,GAGhG,IAAwB,IAAA,IAC1B,EACE,EAAO,KAAK,SAAS,IAAK,GAAY,EAAQ,EAAE,EAChD,EACA,EAAQ,sBACR,CACF,EAEK,CACT"}
+{"version":3,"file":"validateContest.js","names":["parseYaml"],"sources":["../../src/learningMaterial/validateContest.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { basename } from 'node:path';\nimport { getErrorMessage } from '@willbooster/shared-lib';\nimport { parse as parseYaml } from 'yaml';\nimport { collectProblemIdsFromDirectory, isFile, isRegularFile, reportDanglingProblemReferences } from './fsHelpers.js';\nimport { CONTEST_MATERIAL_FILE_SUFFIX, contestFileSchema, LEARNING_MATERIAL_ID_REGEX } from './schemas.js';\nimport {\n  mergeSubmissionPeriods,\n  reportForeignProblemCourseIds,\n  validateSubmissionPeriods,\n  type SubmissionPeriods,\n} from './validateMaterial.js';\nimport { formatZodIssues, reportDuplicateIds, type ValidationResult } from './validationResult.js';\n\nexport interface ContestValidationOptions {\n  /** When set, every contest problem ID must be a problem discovered under this path. */\n  problemsDirectoryPath?: string;\n  /** Problem IDs already collected for the enclosing course; collected from `problemsDirectoryPath` otherwise. */\n  availableProblemIds?: ReadonlySet<string>;\n  /** Enclosing course ID; the judge rejects problem references whose `courseId` differs from it. */\n  courseId?: string;\n  /** Course-level submission periods; the judge merges them as `material[field] ?? course[field]`. */\n  courseSubmissionPeriods?: SubmissionPeriods;\n  /** Set by course validation, which already warns once about a missing problems directory. */\n  isNestedInCourse?: boolean;\n}\n\n/** Validates a judge contest material (`*.contest.yaml`) file. */\nexport async function validateContestFile(\n  contestFilePath: string,\n  options: ContestValidationOptions = {}\n): Promise<ValidationResult> {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n  const result = { errors, warnings };\n\n  // The judge lists lecture entries as regular files, so a symbolic link is skipped at import time.\n  if (!(await isRegularFile(contestFilePath))) {\n    errors.push(\n      (await isFile(contestFilePath))\n        ? `contest file is a symbolic link, which the judge ignores; commit a regular file: ${contestFilePath}`\n        : `contest file not found: ${contestFilePath}`\n    );\n    return result;\n  }\n  const fileName = basename(contestFilePath);\n  if (!fileName.endsWith(CONTEST_MATERIAL_FILE_SUFFIX)) {\n    errors.push(`contest file name must end with ${CONTEST_MATERIAL_FILE_SUFFIX}: ${fileName}`);\n    return result;\n  }\n  const contestId = fileName.slice(0, -CONTEST_MATERIAL_FILE_SUFFIX.length);\n  if (!LEARNING_MATERIAL_ID_REGEX.test(contestId)) {\n    errors.push(\n      `contest ID \"${contestId}\" (file name without ${CONTEST_MATERIAL_FILE_SUFFIX}) must match ${LEARNING_MATERIAL_ID_REGEX}`\n    );\n  }\n\n  let rawContent: unknown;\n  try {\n    rawContent = parseYaml(await readFile(contestFilePath, 'utf8'));\n  } catch (error) {\n    errors.push(`invalid YAML: ${getErrorMessage(error)}`);\n    return result;\n  }\n  const parsed = contestFileSchema.safeParse(rawContent);\n  if (!parsed.success) {\n    errors.push(...formatZodIssues(parsed.error, 'contest'));\n    return result;\n  }\n\n  validateSubmissionPeriods(mergeSubmissionPeriods(parsed.data, options.courseSubmissionPeriods), errors, parsed.data);\n  reportForeignProblemCourseIds(parsed.data.problems, options.courseId, errors);\n  reportDuplicateIds(\n    parsed.data.divisions.map((division) => division.id),\n    'division',\n    errors\n  );\n  reportDuplicateIds(\n    parsed.data.problems.map((problem) => problem.id),\n    'problem',\n    errors\n  );\n\n  let availableProblemIds = options.availableProblemIds;\n  if (availableProblemIds === undefined) {\n    if (options.problemsDirectoryPath === undefined) {\n      if (!options.isNestedInCourse) {\n        warnings.push('no problems directory given (pass --problems-dir); problem references are not checked');\n      }\n    } else {\n      availableProblemIds = await collectProblemIdsFromDirectory(options.problemsDirectoryPath, errors);\n    }\n  }\n  if (availableProblemIds !== undefined) {\n    reportDanglingProblemReferences(\n      parsed.data.problems.map((problem) => problem.id),\n      availableProblemIds,\n      options.problemsDirectoryPath,\n      errors\n    );\n  }\n  return result;\n}\n"],"mappings":"gnBA4BA,eAAsB,EACpB,EACA,EAAoC,CAAC,EACV,CAC3B,IAAM,EAAmB,CAAC,EACpB,EAAqB,CAAC,EACtB,EAAS,CAAE,SAAQ,UAAS,EAGlC,GAAI,CAAE,MAAM,EAAc,CAAe,EAMvC,OALA,EAAO,KACJ,MAAM,EAAO,CAAe,EACzB,oFAAoF,IACpF,2BAA2B,GACjC,EACO,EAET,IAAM,EAAW,EAAS,CAAe,EACzC,GAAI,CAAC,EAAS,SAAA,eAAqC,EAEjD,OADA,EAAO,KAAK,mCAAmC,EAA6B,IAAI,GAAU,EACnF,EAET,IAAM,EAAY,EAAS,MAAM,EAAG,CAAC,EAA6B,MAAM,EACnE,EAA2B,KAAK,CAAS,GAC5C,EAAO,KACL,eAAe,EAAU,uBAAuB,EAA6B,eAAe,GAC9F,EAGF,IAAI,EACJ,GAAI,CACF,EAAaA,EAAU,MAAM,EAAS,EAAiB,MAAM,CAAC,CAChE,OAAS,EAAO,CAEd,OADA,EAAO,KAAK,iBAAiB,EAAgB,CAAK,GAAG,EAC9C,CACT,CACA,IAAM,EAAS,EAAkB,UAAU,CAAU,EACrD,GAAI,CAAC,EAAO,QAEV,OADA,EAAO,KAAK,GAAG,EAAgB,EAAO,MAAO,SAAS,CAAC,EAChD,EAGT,EAA0B,EAAuB,EAAO,KAAM,EAAQ,uBAAuB,EAAG,EAAQ,EAAO,IAAI,EACnH,EAA8B,EAAO,KAAK,SAAU,EAAQ,SAAU,CAAM,EAC5E,EACE,EAAO,KAAK,UAAU,IAAK,GAAa,EAAS,EAAE,EACnD,WACA,CACF,EACA,EACE,EAAO,KAAK,SAAS,IAAK,GAAY,EAAQ,EAAE,EAChD,UACA,CACF,EAEA,IAAI,EAAsB,EAAQ,oBAkBlC,OAjBI,IAAwB,IAAA,KACtB,EAAQ,wBAA0B,IAAA,GAC/B,EAAQ,kBACX,EAAS,KAAK,uFAAuF,EAGvG,EAAsB,MAAM,EAA+B,EAAQ,sBAAuB,CAAM,GAGhG,IAAwB,IAAA,IAC1B,EACE,EAAO,KAAK,SAAS,IAAK,GAAY,EAAQ,EAAE,EAChD,EACA,EAAQ,sBACR,CACF,EAEK,CACT"}

package/dist/learningMaterial/validateCourse.cjs

@@ -1,2 +1,2 @@
-"use strict";const e=require("./schemas.cjs"),t=require("./fsHelpers.cjs"),n=require("./validationResult.cjs"),r=require("./validateMaterial.cjs"),i=require("./validateContest.cjs");let a=require("node:path"),o=require("node:fs/promises"),s=require("yaml");async function c(i,s={}){let c=[],f=[],p={errors:c,warnings:f};if(!await t.isRegularDirectory((0,a.resolve)(i)))return c.push(await t.isDirectory((0,a.resolve)(i))?`course directory is a symbolic link, which the judge does not traverse: ${i}`:`course directory not found: ${i}`),p;let h=await(0,o.realpath)(i),g=s.problemsDirectoryPath===void 0?void 0:await l(s.problemsDirectoryPath),v=(0,a.basename)(h);e.LEARNING_MATERIAL_ID_REGEX.test(v)||c.push(`course ID "${v}" (directory name) must match ${e.LEARNING_MATERIAL_ID_REGEX}`);let y=await d(h,c),b=h,x=await m(h,s.problemsDirectoryPath,g,c);if(!y)return p;let{courseFile:S,courseFileName:C}=y,w=[];r.validateSubmissionPeriods(S,w),c.push(...w.map(e=>`${C}: ${e}`));let T=S.lectures??[];T.length===0&&f.push(`${C} declares no lectures, so no materials are imported`),n.reportDuplicateIds(T.map(e=>e.id),`lecture`,c);for(let e of T)await _(h,{courseId:v,courseSubmissionPeriods:S,problemsDirectoryPath:b,availableProblemIds:x},e.id,c,f);return await u(h,S,C,f),p}async function l(e){let n=(0,a.resolve)(e);if(await t.isRegularDirectory(n))return(0,o.realpath)(n);try{return(0,a.join)(await(0,o.realpath)((0,a.dirname)(n)),(0,a.basename)(n))}catch{return n}}async function u(e,t,n,r){let i=new Set((t.lectures??[]).map(e=>e.id)),s=await(0,o.readdir)(e,{withFileTypes:!0});for(let t of s)!t.isDirectory()||t.name.startsWith(`.`)||i.has(t.name)||t.name===`problems`||(await(0,o.readdir)((0,a.join)(e,t.name),{withFileTypes:!0})).some(e=>e.isFile()&&p(e.name))&&r.push(`directory "${t.name}" is not listed as a lecture in ${n}, so its materials are not imported`)}async function d(r,i){let c=[`course.yaml`,`course.yml`],l=[];for(let e of c)await t.isRegularFile((0,a.join)(r,e))&&l.push(e);if(l.length>1){i.push(`both course.yaml and course.yml exist; the judge rejects the conflicting course files`);return}let u=l[0];if(u===void 0){let e=await f(c,e=>t.isFile((0,a.join)(r,e)));i.push(e===void 0?`course.yaml not found`:`${e} is a symbolic link, which the judge ignores; commit a regular file`);return}let d=(0,a.join)(r,u),p;try{p=(0,s.parse)(await(0,o.readFile)(d,`utf8`))}catch(e){i.push(`${u}: invalid YAML: ${e instanceof Error?e.message:String(e)}`);return}let m=e.courseFileSchema.safeParse(p);if(!m.success){i.push(...n.formatZodIssues(m.error,u));return}return{courseFile:m.data,courseFileName:u}}async function f(e,t){for(let n of e)if(await t(n))return n}function p(e){return e.endsWith(`.contest.yaml`)||e.endsWith(`.md`)&&e!==`problem.md`&&!e.endsWith(`.problem.md`)}async function m(e,n,r,i){let o=await t.collectProblemDefinitions(e);t.reportProblemDefinitionIssues(o,i);let s=new Set(o.keys()),c=(0,a.join)(e,`problems`),l=r!==void 0&&await h(r,c);return(l||await t.isDirectory(c))&&await t.isUsableProblemsDirectory(c,i),r===void 0||l||await t.isUsableProblemsDirectory(r,i)&&g(e,r)&&i.push(`problems directory ${n} is outside the course directory; Exercode links a material only to problems inside the course, so move them under the course`),s}async function h(e,t){if(e===t)return!0;try{let[n,r]=await Promise.all([(0,o.lstat)(e),(0,o.lstat)(t)]);return n.dev===r.dev&&n.ino===r.ino}catch{return!1}}function g(e,t){let n=(0,a.relative)(e,t);return n===`..`||n.startsWith(`..${a.sep}`)}async function _(s,c,l,u,d){let f=(0,a.join)(s,l);if(!await t.isRegularDirectory(f)){u.push(await t.isDirectory(f)?`lecture "${l}": directory is a symbolic link, which the judge does not traverse`:`lecture "${l}": directory not found`);return}let p=[],m=await(0,o.readdir)(f,{withFileTypes:!0});for(let e of m)e.isSymbolicLink()&&u.push(`${l}/${e.name} is a symbolic link, which the judge ignores; commit a regular file`);let h=m.filter(e=>e.isFile()).map(e=>e.name).toSorted((e,t)=>e.localeCompare(t));for(let t of h){let n=(0,a.join)(f,t),o;if(t.endsWith(`.contest.yaml`))p.push(t.slice(0,-e.CONTEST_MATERIAL_FILE_SUFFIX.length)),o=await i.validateContestFile(n,{...c,isNestedInCourse:!0});else if(t.endsWith(`.md`))p.push(t.replace(/\.[^/.]+$/,``)),o=await r.validateMaterialFile(n,c);else continue;u.push(...o.errors.map(e=>`${l}/${t}: ${e}`)),d.push(...o.warnings.map(e=>`${l}/${t}: ${e}`))}p.length===0&&d.push(`lecture "${l}": no material files (*.md or *${e.CONTEST_MATERIAL_FILE_SUFFIX}) found`);let g=[];n.reportDuplicateIds(p,`material`,g),u.push(...g.map(e=>`lecture "${l}": ${e}`))}exports.validateCourseDirectory=c;
+"use strict";const e=require("./schemas.cjs"),t=require("./fsHelpers.cjs"),n=require("./validationResult.cjs"),r=require("./validateMaterial.cjs"),i=require("./validateContest.cjs");let a=require("node:path"),o=require("node:fs/promises"),s=require("@willbooster/shared-lib"),c=require("yaml");async function l(i,s={}){let c=[],l=[],p={errors:c,warnings:l};if(!await t.isRegularDirectory((0,a.resolve)(i)))return c.push(await t.isDirectory((0,a.resolve)(i))?`course directory is a symbolic link, which the judge does not traverse: ${i}`:`course directory not found: ${i}`),p;let m=await(0,o.realpath)(i),g=s.problemsDirectoryPath===void 0?void 0:await u(s.problemsDirectoryPath),_=(0,a.basename)(m);e.LEARNING_MATERIAL_ID_REGEX.test(_)||c.push(`course ID "${_}" (directory name) must match ${e.LEARNING_MATERIAL_ID_REGEX}`);let y=await f(m,c),b=m,x=await h(m,s.problemsDirectoryPath,g,c);if(!y)return p;let{courseFile:S,courseFileName:C}=y,w=[];r.validateSubmissionPeriods(S,w),c.push(...w.map(e=>`${C}: ${e}`));let T=S.lectures??[];T.length===0&&l.push(`${C} declares no lectures, so no materials are imported`),n.reportDuplicateIds(T.map(e=>e.id),`lecture`,c);for(let e of T)await v(m,{courseId:_,courseSubmissionPeriods:S,problemsDirectoryPath:b,availableProblemIds:x},e.id,c,l);return await d(m,S,C,l),p}async function u(e){let n=(0,a.resolve)(e);if(await t.isRegularDirectory(n))return(0,o.realpath)(n);try{return(0,a.join)(await(0,o.realpath)((0,a.dirname)(n)),(0,a.basename)(n))}catch{return n}}async function d(e,t,n,r){let i=new Set((t.lectures??[]).map(e=>e.id)),s=await(0,o.readdir)(e,{withFileTypes:!0});for(let t of s)!t.isDirectory()||t.name.startsWith(`.`)||i.has(t.name)||t.name===`problems`||(await(0,o.readdir)((0,a.join)(e,t.name),{withFileTypes:!0})).some(e=>e.isFile()&&m(e.name))&&r.push(`directory "${t.name}" is not listed as a lecture in ${n}, so its materials are not imported`)}async function f(r,i){let l=[`course.yaml`,`course.yml`],u=[];for(let e of l)await t.isRegularFile((0,a.join)(r,e))&&u.push(e);if(u.length>1){i.push(`both course.yaml and course.yml exist; the judge rejects the conflicting course files`);return}let d=u[0];if(d===void 0){let e=await p(l,e=>t.isFile((0,a.join)(r,e)));i.push(e===void 0?`course.yaml not found`:`${e} is a symbolic link, which the judge ignores; commit a regular file`);return}let f=(0,a.join)(r,d),m;try{m=(0,c.parse)(await(0,o.readFile)(f,`utf8`))}catch(e){i.push(`${d}: invalid YAML: ${(0,s.getErrorMessage)(e)}`);return}let h=e.courseFileSchema.safeParse(m);if(!h.success){i.push(...n.formatZodIssues(h.error,d));return}return{courseFile:h.data,courseFileName:d}}async function p(e,t){for(let n of e)if(await t(n))return n}function m(e){return e.endsWith(`.contest.yaml`)||e.endsWith(`.md`)&&e!==`problem.md`&&!e.endsWith(`.problem.md`)}async function h(e,n,r,i){let o=await t.collectProblemDefinitions(e);t.reportProblemDefinitionIssues(o,i);let s=new Set(o.keys()),c=(0,a.join)(e,`problems`),l=r!==void 0&&await g(r,c);return(l||await t.isDirectory(c))&&await t.isUsableProblemsDirectory(c,i),r===void 0||l||await t.isUsableProblemsDirectory(r,i)&&_(e,r)&&i.push(`problems directory ${n} is outside the course directory; Exercode links a material only to problems inside the course, so move them under the course`),s}async function g(e,t){if(e===t)return!0;try{let[n,r]=await Promise.all([(0,o.lstat)(e),(0,o.lstat)(t)]);return n.dev===r.dev&&n.ino===r.ino}catch{return!1}}function _(e,t){let n=(0,a.relative)(e,t);return n===`..`||n.startsWith(`..${a.sep}`)}async function v(s,c,l,u,d){let f=(0,a.join)(s,l);if(!await t.isRegularDirectory(f)){u.push(await t.isDirectory(f)?`lecture "${l}": directory is a symbolic link, which the judge does not traverse`:`lecture "${l}": directory not found`);return}let p=[],m=await(0,o.readdir)(f,{withFileTypes:!0});for(let e of m)e.isSymbolicLink()&&u.push(`${l}/${e.name} is a symbolic link, which the judge ignores; commit a regular file`);let h=m.filter(e=>e.isFile()).map(e=>e.name).toSorted((e,t)=>e.localeCompare(t));for(let t of h){let n=(0,a.join)(f,t),o;if(t.endsWith(`.contest.yaml`))p.push(t.slice(0,-e.CONTEST_MATERIAL_FILE_SUFFIX.length)),o=await i.validateContestFile(n,{...c,isNestedInCourse:!0});else if(t.endsWith(`.md`))p.push(t.replace(/\.[^/.]+$/,``)),o=await r.validateMaterialFile(n,c);else continue;u.push(...o.errors.map(e=>`${l}/${t}: ${e}`)),d.push(...o.warnings.map(e=>`${l}/${t}: ${e}`))}p.length===0&&d.push(`lecture "${l}": no material files (*.md or *${e.CONTEST_MATERIAL_FILE_SUFFIX}) found`);let g=[];n.reportDuplicateIds(p,`material`,g),u.push(...g.map(e=>`lecture "${l}": ${e}`))}exports.validateCourseDirectory=l;
 //# sourceMappingURL=validateCourse.cjs.map