@learnpack/learnpack 5.0.364 → 5.0.366

package/lib/commands/serve.js

@@ -25,6 +25,7 @@ const dotenv = require("dotenv");
 const creatorUtilities_1 = require("../utils/creatorUtilities");
 const lessonRecovery_1 = require("../utils/lessonRecovery");
 const generationRetry_1 = require("../utils/generationRetry");
+const continueGeneration_1 = require("../utils/continueGeneration");
 // import { handleAssetCreation } from "./publish"
 const axios_1 = require("axios");
 const FormData = require("form-data");
@@ -1518,6 +1519,28 @@ class ServeCommand extends SessionCommand_1.default {
                 if (!exercise.id || !exercise.title) {
                     throw new errorHandler_1.ValidationError(`Lesson "${lessonUid}" is missing required properties (id or title)`);
                 }
+                const language = syllabus.courseInfo.language || "en";
+                const previousStatus = exercise.status;
+                // A second click, or a retry while the job still runs, would start
+                // another paid job for the same lesson.
+                if (previousStatus === "GENERATING") {
+                    const jobId = (0, continueGeneration_1.currentJobId)(exercise, language);
+                    let job = null;
+                    if (jobId) {
+                        try {
+                            job = await (0, rigoActions_1.getCompletionJob)(rigoToken, jobId, {
+                                timeoutMs: 5000,
+                            });
+                        }
+                        catch (error) {
+                            console.error(`Could not check job ${jobId}:`, error);
+                        }
+                    }
+                    if ((0, continueGeneration_1.isGenerationRunning)(exercise, language, job, Date.now())) {
+                        console.log(`Lesson ${lessonUid} is already being generated (job ${jobId}), not starting another one`);
+                        throw new errorHandler_1.ConflictError(`Lesson "${exercise.title}" is already being generated`, { code: "LESSON_ALREADY_GENERATING", completionId: jobId });
+                    }
+                }
                 // previous exercise
                 let previousReadme = "---";
                 const previousExercise = syllabus.lessons[exerciseIndex - 1];
@@ -1543,7 +1566,7 @@ class ServeCommand extends SessionCommand_1.default {
                 // A new job by the user, so the automatic retries start over.
                 syllabus.lessons[exerciseIndex].status = "GENERATING";
                 syllabus.lessons[exerciseIndex].translations = {
-                    [syllabus.courseInfo.language || "en"]: startedJob(completionId),
+                    [language]: startedJob(completionId),
                 };
                 console.log("Lesson", syllabus.lessons[exerciseIndex]);
                 if (syllabus.feedback && typeof syllabus.feedback === "string") {
@@ -1552,7 +1575,7 @@ class ServeCommand extends SessionCommand_1.default {
                 else {
                     syllabus.feedback = feedback;
                 }
-                syllabus.generationMode = mode;
+                syllabus.generationMode = (0, continueGeneration_1.resolveGenerationMode)(previousStatus, syllabus.generationMode, mode);
                 await saveSyllabus(courseSlug, syllabus, bucket);
             });
             res.json({ status: "SUCCESS" });
@@ -3763,9 +3786,12 @@ class ServeCommand extends SessionCommand_1.default {
                 await uploadInitialReadme(bucket, exSlug, targetDir, syllabus.courseInfo);
             }
             const sidebar = await (0, sidebar_1.createInitialSidebar)(syllabus.lessons.map(lesson => (0, creatorUtilities_2.slugify)(lesson.id + "-" + lesson.title)), syllabus.courseInfo.language);
+            const language = syllabus.courseInfo.language || "en";
             const initialSyllabus = Object.assign(Object.assign({}, syllabus), { lessons: syllabus.lessons.map((lesson, index) => {
                     if (index < 1) {
-                        return Object.assign(Object.assign({}, lesson), { generated: false, status: "GENERATING" });
+                        // Its start time, so a retry right away is refused even before
+                        // the job id is saved below.
+                        return Object.assign(Object.assign({}, lesson), { generated: false, status: "GENERATING", translations: { [language]: startedJob(0) } });
                     }
                     return Object.assign(Object.assign({}, lesson), { generated: false, status: "PENDING" });
                 }) });
@@ -3773,17 +3799,16 @@ class ServeCommand extends SessionCommand_1.default {
             await (0, bucketIo_1.uploadFileToBucket)(bucket, JSON.stringify(sidebar), `${tutorialDir}/.learn/sidebar.json`);
             const firstLesson = syllabus.lessons[0];
             const lastResult = "---";
-            // Use new two-phase generation workflow
-            const completionId = await startInitialContentGeneration(rigoToken, syllabus.lessons, syllabus.courseInfo, firstLesson, courseSlug, syllabus.courseInfo.purpose, lastResult);
-            if (firstLesson) {
-                firstLesson.translations = {
-                    [syllabus.courseInfo.language || "en"]: {
-                        completionId,
-                        startedAt: Date.now(),
-                        completedAt: 0,
-                    },
-                };
-            }
+            // In the course queue, so the webhook of this job waits until its id
+            // is saved. The id was never saved before, so the first lesson had no
+            // protection against a second job.
+            await serializeByCourse(courseSlug, async () => {
+                // Use new two-phase generation workflow
+                const completionId = await startInitialContentGeneration(rigoToken, syllabus.lessons, syllabus.courseInfo, firstLesson, courseSlug, syllabus.courseInfo.purpose, lastResult);
+                await patchLesson(courseSlug, firstLesson.uid, bucket, lesson => {
+                    lesson.translations = { [language]: startedJob(completionId) };
+                });
+            });
             await createInitialReadme(JSON.stringify(syllabus.courseInfo), courseSlug, rigoToken);
             return res.json({
                 message: "Course generation started",

package/lib/managers/config/index.js

@@ -12,11 +12,10 @@ const sidebarGenerator_1 = require("../../utils/sidebarGenerator");
 const defaults_1 = require("./defaults");
 const exercise_1 = require("./exercise");
 const file_1 = require("../file");
+const ideReleases_1 = require("../ideReleases");
 /* exercise folder name standard */
 const execAsync = (0, util_1.promisify)(child_process_1.exec);
 // eslint-disable-next-line
-const fetch = require("node-fetch");
-// eslint-disable-next-line
 const chalk = require("chalk");
 /* exercise folder name standard */
 /**
@@ -186,9 +185,7 @@ exports.default = async ({ grading, mode, disableGrading, version, }) => {
         configObj.config.editor.version = version;
     else if (configObj.config.editor.version === null) {
         console_1.default.debug("Config version not found, downloading default.");
-        const resp = await fetch("https://raw.githubusercontent.com/learnpack/ide/master/package.json");
-        const packageJSON = await resp.json();
-        configObj.config.editor.version = packageJSON.version || "5.0.0";
+        configObj.config.editor.version = await (0, ideReleases_1.getLatestEditorVersion)();
     }
     configObj.config.dirPath = "./" + confPath.base;
     configObj.config.exercisesPath = getExercisesPath(confPath.base) || "./";

package/lib/managers/file.js

@@ -9,6 +9,7 @@ const targz = require("targz");
 const console_1 = require("../utils/console");
 const https = require("https");
 const errors_1 = require("../utils/errors");
+const ideReleases_1 = require("./ideReleases");
 // eslint-disable-next-line
 const fetch = require("node-fetch");
 const decompress = (sourcePath, destinationPath) => new Promise((resolve, reject) => {
@@ -30,54 +31,22 @@ const decompress = (sourcePath, destinationPath) => new Promise((resolve, reject
 exports.decompress = decompress;
 const downloadEditor = async (version, destination) => {
     console_1.default.info("Downloading the LearnPack coding UI, this may take a minute...");
-    if (!version) {
-        const res = await fetch("https://raw.githubusercontent.com/learnpack/ide/master/package.json");
-        const json = await res.json();
-        version = json.version || "4.0.0";
-        if (!version)
-            throw (0, errors_1.InternalError)(`Coding Editor version was not found on learnpack repository, check the config.editor.version property on learn.json`);
+    if (!version)
+        version = await (0, ideReleases_1.getLatestEditorVersion)();
+    const [cloudTags, githubTags] = await Promise.all([
+        (0, ideReleases_1.fetchTagList)(ideReleases_1.IDE_CLOUDFRONT_MANIFEST),
+        (0, ideReleases_1.fetchTagList)(ideReleases_1.IDE_GITHUB_MANIFEST),
+    ]);
+    let release = (0, ideReleases_1.resolveEditorRelease)(version, cloudTags, githubTags);
+    if (!release) {
+        console_1.default.debug(`No IDE version found for ${version} in the versions manifests, defaulting to version 4.0.2`);
+        release = { version: "4.0.2", source: "github" };
     }
-    const [major, minor] = version.split(".");
-    const versionPrefix = `${major}.${minor}`;
-    let tags;
-    try {
-        const tagsRes = await fetch("https://raw.githubusercontent.com/learnpack/ide/master/versions.json");
-        tags = await tagsRes.json();
-        if (!Array.isArray(tags)) {
-            throw new TypeError(`Invalid versions.json format`);
-        }
-    }
-    catch (error) {
-        console_1.default.debug("Error reading versions.json, defaulting to version 4.0.2", error);
-        version = "4.0.2";
-        tags = [`learnpack-${version}.tar.gz`];
-    }
-    let matchingTags;
-    try {
-        if (tags.length === 0 || !tags)
-            throw (0, errors_1.InternalError)(`No found tags in versions.json ${tags}`);
-        matchingTags = tags
-            .filter(tag => tag.includes(`learnpack-${versionPrefix}`))
-            .sort((a, b) => b.localeCompare(a, undefined, { numeric: true }));
-        if (matchingTags.length === 0)
-            throw (0, errors_1.InternalError)(`No matching version found for prefix ${versionPrefix} in the versions.json`);
-    }
-    catch (error) {
-        console_1.default.debug("Error processing tags, defaulting to version 4.0.2", error);
-        version = "4.0.2";
-        matchingTags = [`learnpack-${version}.tar.gz`];
-    }
-    const latestVersion = matchingTags[0]
-        .replace("learnpack-", "")
-        .replace(".tar.gz", "");
-    const versionNumber = parseInt(latestVersion.split(".")[0]);
-    let url = `https://github.com/learnpack/coding-ide/blob/${latestVersion}/dist`;
-    if (versionNumber > 2)
-        url = `https://github.com/learnpack/ide/blob/master/bin/learnpack-${latestVersion}.tar.gz`;
-    const resp2 = await fetch(url, { method: "HEAD" });
-    if (!resp2.ok)
-        throw (0, errors_1.InternalError)(`Coding Editor ${latestVersion} was not found on learnpack repository, check the config.editor.version property on learn.json`);
-    url += versionNumber > 2 ? `?raw=true` : `/app.tar.gz?raw=true`;
+    const url = (0, ideReleases_1.editorTarballUrl)(release.version, release.source);
+    const resp = await fetch(url, { method: "HEAD", timeout: ideReleases_1.FETCH_TIMEOUT_MS });
+    if (!resp.ok)
+        throw (0, errors_1.InternalError)(`Coding Editor ${release.version} was not found on ${release.source}, check the config.editor.version property on learn.json`);
+    console_1.default.debug(`Using IDE ${release.version} from ${release.source}`);
     return (0, exports.download)(url, destination);
 };
 exports.downloadEditor = downloadEditor;
@@ -92,7 +61,7 @@ const download = (url, dest) => {
                 });
                 file.on("error", err => {
                     file.close();
-                    if (err.name === "EEXIST") {
+                    if (err.code === "EEXIST") {
                         console_1.default.debug("File already exists");
                         resolve("File already exists");
                     }
@@ -103,11 +72,10 @@ const download = (url, dest) => {
                 });
                 response.pipe(file);
             }
-            else if (response.statusCode === 302 || response.statusCode === 301) {
-                // Console.debug("Servers redirected to "+response.headers.location)
+            else if ([301, 302, 303, 307, 308].includes(response.statusCode || 0)) {
                 // Recursively follow redirects, only a 200 will resolve.
                 if (response.headers.location) {
-                    (0, exports.download)(response.headers.location, dest)
+                    (0, exports.download)(new URL(response.headers.location, url).toString(), dest)
                         .then(() => resolve(/* */ ""))
                         .catch(error => {
                         console_1.default.error(error);

package/lib/managers/ideReleases.d.ts

@@ -0,0 +1,24 @@
+export declare const IDE_CLOUDFRONT_BASE = "https://d3a7w3e3g8ydll.cloudfront.net/learnpack/ide";
+export declare const IDE_CLOUDFRONT_MANIFEST = "https://d3a7w3e3g8ydll.cloudfront.net/learnpack/ide/versions.json";
+export declare const IDE_GITHUB_MANIFEST = "https://raw.githubusercontent.com/learnpack/ide/master/versions.json";
+export declare const IDE_GITHUB_PACKAGE = "https://raw.githubusercontent.com/learnpack/ide/master/package.json";
+export declare const FETCH_TIMEOUT_MS = 10000;
+export type TEditorSource = "cloudfront" | "github";
+export interface IEditorRelease {
+    version: string;
+    source: TEditorSource;
+}
+interface IParsedVersion {
+    version: string;
+    major: number;
+    minor: number;
+    patch: number;
+}
+export declare const parseVersion: (version: string) => IParsedVersion | null;
+export declare const parseTag: (tag: string) => IParsedVersion | null;
+export declare const highestVersion: (tags: string[] | null) => string | null;
+export declare const resolveEditorRelease: (requested: string, cloudTags: string[] | null, githubTags: string[] | null) => IEditorRelease | null;
+export declare const editorTarballUrl: (version: string, source: TEditorSource) => string;
+export declare const fetchTagList: (url: string) => Promise<string[] | null>;
+export declare const getLatestEditorVersion: () => Promise<string>;
+export {};

package/lib/managers/ideReleases.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLatestEditorVersion = exports.fetchTagList = exports.editorTarballUrl = exports.resolveEditorRelease = exports.highestVersion = exports.parseTag = exports.parseVersion = exports.FETCH_TIMEOUT_MS = exports.IDE_GITHUB_PACKAGE = exports.IDE_GITHUB_MANIFEST = exports.IDE_CLOUDFRONT_MANIFEST = exports.IDE_CLOUDFRONT_BASE = void 0;
+const console_1 = require("../utils/console");
+// eslint-disable-next-line
+const fetch = require("node-fetch");
+// IDE tarballs published from 5.0.417 on live on CloudFront; older ones stay in the
+// learnpack/ide GitHub repo, whose versions.json is frozen. Both lists are merged.
+exports.IDE_CLOUDFRONT_BASE = "https://d3a7w3e3g8ydll.cloudfront.net/learnpack/ide";
+exports.IDE_CLOUDFRONT_MANIFEST = `${exports.IDE_CLOUDFRONT_BASE}/versions.json`;
+exports.IDE_GITHUB_MANIFEST = "https://raw.githubusercontent.com/learnpack/ide/master/versions.json";
+exports.IDE_GITHUB_PACKAGE = "https://raw.githubusercontent.com/learnpack/ide/master/package.json";
+exports.FETCH_TIMEOUT_MS = 10000;
+const DEFAULT_EDITOR_VERSION = "5.0.0";
+const parseVersion = (version) => {
+    const match = /^(\d+)\.(\d+)\.(\d+)$/.exec(version.trim());
+    if (!match)
+        return null;
+    return {
+        version: match.slice(1, 4).join("."),
+        major: Number(match[1]),
+        minor: Number(match[2]),
+        patch: Number(match[3]),
+    };
+};
+exports.parseVersion = parseVersion;
+// "learnpack-5.0.417.tar.gz" -> parsed 5.0.417; anything else -> null
+const parseTag = (tag) => {
+    const match = /^learnpack-(\d+\.\d+\.\d+)\.tar\.gz$/.exec(tag);
+    return match ? (0, exports.parseVersion)(match[1]) : null;
+};
+exports.parseTag = parseTag;
+const compareVersions = (a, b) => a.major - b.major || a.minor - b.minor || a.patch - b.patch;
+const parseTags = (tags) => (tags || []).map(exports.parseTag).filter((v) => v !== null);
+// Highest version listed in a manifest, or null when there is none.
+const highestVersion = (tags) => {
+    const sorted = parseTags(tags).sort(compareVersions);
+    return sorted.length > 0 ? sorted[sorted.length - 1].version : null;
+};
+exports.highestVersion = highestVersion;
+// Picks the tarball to download for the requested version. Only major.minor of the
+// request is used and the highest patch available wins, as the CLI always did.
+// The source is CloudFront when the version is in its manifest, GitHub otherwise.
+const resolveEditorRelease = (requested, cloudTags, githubTags) => {
+    const [major, minor] = requested.split(".").map(part => Number(part));
+    if (!Number.isInteger(major) || !Number.isInteger(minor))
+        return null;
+    const cloud = parseTags(cloudTags);
+    const candidates = [...cloud, ...parseTags(githubTags)]
+        .filter(v => v.major === major && v.minor === minor)
+        .sort(compareVersions);
+    if (candidates.length === 0)
+        return null;
+    const { version } = candidates[candidates.length - 1];
+    const source = cloud.some(v => v.version === version) ?
+        "cloudfront" :
+        "github";
+    return { version, source };
+};
+exports.resolveEditorRelease = resolveEditorRelease;
+const editorTarballUrl = (version, source) => {
+    if (source === "cloudfront") {
+        return `${exports.IDE_CLOUDFRONT_BASE}/learnpack-${version}.tar.gz`;
+    }
+    const major = Number.parseInt(version.split(".")[0], 10);
+    return major > 2 ?
+        `https://github.com/learnpack/ide/blob/master/bin/learnpack-${version}.tar.gz?raw=true` :
+        `https://github.com/learnpack/coding-ide/blob/${version}/dist/app.tar.gz?raw=true`;
+};
+exports.editorTarballUrl = editorTarballUrl;
+// Fetches a versions manifest. Never throws: any failure returns null.
+const fetchTagList = async (url) => {
+    try {
+        const res = await fetch(url, { timeout: exports.FETCH_TIMEOUT_MS });
+        if (!res.ok) {
+            console_1.default.debug(`Could not read ${url}: ${res.status} ${res.statusText}`);
+            return null;
+        }
+        const json = await res.json();
+        if (!Array.isArray(json) || !json.every(tag => typeof tag === "string")) {
+            console_1.default.debug(`Invalid versions manifest format at ${url}`);
+            return null;
+        }
+        return json;
+    }
+    catch (error) {
+        console_1.default.debug(`Could not read ${url}`, error);
+        return null;
+    }
+};
+exports.fetchTagList = fetchTagList;
+// Latest published IDE version: CloudFront manifest, then GitHub package.json, then a default.
+const getLatestEditorVersion = async () => {
+    const fromCloud = (0, exports.highestVersion)(await (0, exports.fetchTagList)(exports.IDE_CLOUDFRONT_MANIFEST));
+    if (fromCloud)
+        return fromCloud;
+    try {
+        const res = await fetch(exports.IDE_GITHUB_PACKAGE, { timeout: exports.FETCH_TIMEOUT_MS });
+        if (res.ok) {
+            const json = await res.json();
+            if (typeof (json === null || json === void 0 ? void 0 : json.version) === "string" && (0, exports.parseVersion)(json.version)) {
+                return json.version;
+            }
+        }
+    }
+    catch (error) {
+        console_1.default.debug("Could not read the IDE package.json from GitHub", error);
+    }
+    return DEFAULT_EDITOR_VERSION;
+};
+exports.getLatestEditorVersion = getLatestEditorVersion;

package/lib/utils/continueGeneration.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Rules for `POST /actions/continue-generating`, the request behind the
+ * creator's continue and retry buttons. Without them, every extra click starts
+ * another paid job for a lesson that is already being generated.
+ */
+/**
+ * How long a PENDING job counts as running. Each phase of a lesson takes 1 to
+ * 3 minutes, so a job PENDING for longer is most likely stuck, for example
+ * after a worker restart. A stuck job holds the whole course, because the next
+ * lesson only starts after this one finishes. Replacing a slow job that was
+ * still alive only costs one extra job: serve ignores the older job's webhook.
+ */
+export declare const RUNNING_JOB_MAX_AGE_MS: number;
+/**
+ * How long a finished job counts as running. Rigobot saves the result before
+ * it sends the webhook, and serve may still be handling it.
+ */
+export declare const WEBHOOK_GRACE_MS: number;
+/**
+ * How long a lesson counts as running when its job cannot be checked: it has
+ * no job id yet, or Rigobot did not answer.
+ */
+export declare const UNCHECKED_JOB_GRACE_MS: number;
+export type GenerationMode = "next-three" | "continue-with-all";
+type LessonState = {
+    status?: string;
+    translations?: {
+        [language: string]: {
+            completionId?: number;
+            startedAt?: number;
+        };
+    };
+};
+/** The fields of a Rigobot completion job these rules read. */
+export type JobState = {
+    status?: string;
+    ended_at?: string | null;
+};
+/**
+ * The job to check before starting another one.
+ * @param lesson - The lesson as saved in the syllabus.
+ * @param language - The course language.
+ * @returns The id of the job the lesson waits for, or null if it has none.
+ */
+export declare const currentJobId: (lesson: LessonState, language: string) => number | null;
+/**
+ * Whether a lesson is still being generated, so a new job must not start.
+ * @param lesson - The lesson as saved in the syllabus.
+ * @param language - The course language.
+ * @param job - Its job as Rigobot reports it, or null if it was not checked.
+ * @param now - The current time in milliseconds.
+ * @returns True when the lesson must wait for its current job.
+ */
+export declare const isGenerationRunning: (lesson: LessonState, language: string, job: JobState | null, now: number) => boolean;
+/**
+ * The generation mode to save. The user only picks a mode on a PENDING
+ * lesson. The retry buttons offer no choice, so a retry keeps the mode of the
+ * course instead of resetting it.
+ * @param lessonStatus - The status of the lesson before this request.
+ * @param current - The mode saved in the syllabus.
+ * @param requested - The mode in the request.
+ * @returns The mode to save, or undefined when the course has none.
+ */
+export declare const resolveGenerationMode: (lessonStatus: string | undefined, current: unknown, requested: unknown) => GenerationMode | undefined;
+export {};

package/lib/utils/continueGeneration.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * Rules for `POST /actions/continue-generating`, the request behind the
+ * creator's continue and retry buttons. Without them, every extra click starts
+ * another paid job for a lesson that is already being generated.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveGenerationMode = exports.isGenerationRunning = exports.currentJobId = exports.UNCHECKED_JOB_GRACE_MS = exports.WEBHOOK_GRACE_MS = exports.RUNNING_JOB_MAX_AGE_MS = void 0;
+/**
+ * How long a PENDING job counts as running. Each phase of a lesson takes 1 to
+ * 3 minutes, so a job PENDING for longer is most likely stuck, for example
+ * after a worker restart. A stuck job holds the whole course, because the next
+ * lesson only starts after this one finishes. Replacing a slow job that was
+ * still alive only costs one extra job: serve ignores the older job's webhook.
+ */
+exports.RUNNING_JOB_MAX_AGE_MS = 5 * 60 * 1000;
+/**
+ * How long a finished job counts as running. Rigobot saves the result before
+ * it sends the webhook, and serve may still be handling it.
+ */
+exports.WEBHOOK_GRACE_MS = 90 * 1000;
+/**
+ * How long a lesson counts as running when its job cannot be checked: it has
+ * no job id yet, or Rigobot did not answer.
+ */
+exports.UNCHECKED_JOB_GRACE_MS = 2 * 60 * 1000;
+/**
+ * The job to check before starting another one.
+ * @param lesson - The lesson as saved in the syllabus.
+ * @param language - The course language.
+ * @returns The id of the job the lesson waits for, or null if it has none.
+ */
+const currentJobId = (lesson, language) => {
+    var _a, _b;
+    const id = (_b = (_a = lesson.translations) === null || _a === void 0 ? void 0 : _a[language]) === null || _b === void 0 ? void 0 : _b.completionId;
+    return typeof id === "number" && id > 0 ? id : null;
+};
+exports.currentJobId = currentJobId;
+/**
+ * Whether a lesson is still being generated, so a new job must not start.
+ * @param lesson - The lesson as saved in the syllabus.
+ * @param language - The course language.
+ * @param job - Its job as Rigobot reports it, or null if it was not checked.
+ * @param now - The current time in milliseconds.
+ * @returns True when the lesson must wait for its current job.
+ */
+const isGenerationRunning = (lesson, language, job, now) => {
+    var _a, _b;
+    if (lesson.status !== "GENERATING")
+        return false;
+    const startedAt = (_b = (_a = lesson.translations) === null || _a === void 0 ? void 0 : _a[language]) === null || _b === void 0 ? void 0 : _b.startedAt;
+    const startedAgo = typeof startedAt === "number" && startedAt > 0 ?
+        now - startedAt :
+        Number.POSITIVE_INFINITY;
+    if (!job)
+        return startedAgo < exports.UNCHECKED_JOB_GRACE_MS;
+    if (job.status === "PENDING")
+        return startedAgo < exports.RUNNING_JOB_MAX_AGE_MS;
+    // A finished job. Its webhook may still be on its way to serve.
+    const endedAt = job.ended_at ? Date.parse(job.ended_at) : Number.NaN;
+    if (Number.isNaN(endedAt))
+        return startedAgo < exports.UNCHECKED_JOB_GRACE_MS;
+    return now - endedAt < exports.WEBHOOK_GRACE_MS;
+};
+exports.isGenerationRunning = isGenerationRunning;
+/**
+ * The generation mode to save. The user only picks a mode on a PENDING
+ * lesson. The retry buttons offer no choice, so a retry keeps the mode of the
+ * course instead of resetting it.
+ * @param lessonStatus - The status of the lesson before this request.
+ * @param current - The mode saved in the syllabus.
+ * @param requested - The mode in the request.
+ * @returns The mode to save, or undefined when the course has none.
+ */
+const resolveGenerationMode = (lessonStatus, current, requested) => {
+    const isMode = (mode) => mode === "next-three" || mode === "continue-with-all";
+    if (isMode(requested) && (lessonStatus === "PENDING" || !isMode(current))) {
+        return requested;
+    }
+    return isMode(current) ? current : undefined;
+};
+exports.resolveGenerationMode = resolveGenerationMode;

package/lib/utils/rigoActions.d.ts

@@ -26,6 +26,7 @@ export type TCompletionJob = {
     status: "PENDING" | "SUCCESS" | "ERROR" | string;
     status_text?: string | null;
     parsed?: Record<string, any> | null;
+    ended_at?: string | null;
 };
 type TTranslateAndWaitOptions = {
     /** How often the job status is checked while it is still running. */
@@ -35,7 +36,9 @@ type TTranslateAndWaitOptions = {
     /** Called after every successful poll, useful to keep a heartbeat alive. */
     onPoll?: (job: TCompletionJob) => void | Promise<void>;
 };
-export declare const getCompletionJob: (token: string, completionId: number | string) => Promise<TCompletionJob>;
+export declare const getCompletionJob: (token: string, completionId: number | string, options?: {
+    timeoutMs?: number;
+}) => Promise<TCompletionJob>;
 export declare const translateExerciseAndWait: (token: string, inputs: TTranslateInputs, options?: TTranslateAndWaitOptions) => Promise<TCompletionJob>;
 type TGenerateCourseIntroductionInputs = {
     course_title: string;

package/lib/utils/rigoActions.js

@@ -114,12 +114,14 @@ const assertJobSucceeded = (job) => {
     }
     return job;
 };
-const getCompletionJob = async (token, completionId) => {
+const getCompletionJob = async (token, completionId, options = {}) => {
     const response = await axios_1.default.get(`${api_1.RIGOBOT_HOST}/v1/prompting/completion/${completionId}/`, {
         headers: {
             "Content-Type": "application/json",
             Authorization: "Token " + token,
         },
+        // No timeout by default: the translation polling waits as long as it needs.
+        timeout: options.timeoutMs,
     });
     return response.data;
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@learnpack/learnpack",
   "description": "Seamlessly build, sell and/or take interactive & auto-graded tutorials, start learning now or build a new tutorial to your audience.",
-  "version": "5.0.364",
+  "version": "5.0.366",
   "author": "Alejandro Sanchez @alesanchezr",
   "contributors": [
     {