@learnpack/learnpack 5.0.358 → 5.0.359

package/lib/commands/publish.d.ts

@@ -1,14 +1,4 @@
 import SessionCommand from "../utils/SessionCommand";
-type ExistingAssetInfo = {
-    lang: string;
-    slug: string;
-    exists: boolean;
-    academyId?: number;
-};
-export declare const handleAssetCreation: (sessionPayload: {
-    token: string;
-    rigobotToken: string;
-}, learnJson: any, selectedLang: string, learnpackDeployUrl: string, b64IndexReadme: string, academyId: number | undefined, learnpackId: number, preflightInfo?: ExistingAssetInfo, all_translations?: string[]) => Promise<any>;
 declare class BuildCommand extends SessionCommand {
     static description: string;
     static flags: {

package/lib/commands/publish.js

@@ -1,6 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleAssetCreation = void 0;
 /* eslint-disable arrow-parens */
 /* eslint-disable unicorn/no-array-for-each */
 const child_process_1 = require("child_process");
@@ -20,181 +19,55 @@ const rigoActions_1 = require("../utils/rigoActions");
 const misc_1 = require("../utils/misc");
 const creatorUtilities_1 = require("../utils/creatorUtilities");
 const branding_1 = require("../utils/branding");
+const assetResolver_1 = require("../utils/assetResolver");
+const assetSync_1 = require("../utils/assetSync");
 const uploadZipEndpont = api_1.RIGOBOT_HOST + "/v1/learnpack/upload";
-const getAvailableLangs = (learnJson) => {
-    const langs = Object.keys((learnJson === null || learnJson === void 0 ? void 0 : learnJson.title) || {});
-    return langs.filter((l) => typeof l === "string" && l.length > 0);
-};
 const getDefaultLang = (learnJson) => {
-    const availableLangs = getAvailableLangs(learnJson);
+    const availableLangs = (0, assetResolver_1.getAvailableLangs)(learnJson);
     if (availableLangs.length === 0)
         return "en";
     return availableLangs.includes("en") ? "en" : availableLangs[0];
 };
-const getLocalizedValue = (translations, lang, fallbackLangs = ["en", "us"]) => {
-    if (!translations || typeof translations !== "object")
-        return "";
-    const direct = translations[lang];
-    if (typeof direct === "string" && direct.trim().length > 0)
-        return direct;
-    for (const fb of fallbackLangs) {
-        const v = translations[fb];
-        if (typeof v === "string" && v.trim().length > 0)
-            return v;
-    }
-    const firstKey = Object.keys(translations)[0];
-    const first = firstKey ? translations[firstKey] : "";
-    return typeof first === "string" ? first : "";
-};
-const getExistingAssetsInfo = async (token, learnJson) => {
-    const availableLangs = getAvailableLangs(learnJson);
-    const results = [];
-    for (const lang of availableLangs) {
-        const assetTitle = getLocalizedValue(learnJson === null || learnJson === void 0 ? void 0 : learnJson.title, lang);
-        if (!assetTitle)
-            continue;
-        let slug = (0, creatorUtilities_1.slugify)(assetTitle).slice(0, 47);
-        slug = `${slug}-${lang}`;
-        // eslint-disable-next-line no-await-in-loop
-        const { exists, academyId } = await api_1.default.doesAssetExists(token, slug);
-        results.push({ lang, slug, exists, academyId });
-    }
-    return results;
-};
-const determinePublishAcademyMode = (existingAssets) => {
-    const academyIds = existingAssets
-        .filter((a) => a.exists && a.academyId !== undefined)
-        .map((a) => a.academyId);
-    const unique = [...new Set(academyIds)];
-    if (unique.length === 0)
-        return { type: "select" };
-    if (unique.length === 1)
-        return { type: "locked", academyId: unique[0] };
-    return { type: "conflict", academies: unique };
-};
-const handleAssetCreation = async (sessionPayload, learnJson, selectedLang, learnpackDeployUrl, b64IndexReadme, academyId, learnpackId, preflightInfo, all_translations = []) => {
-    const category = "uncategorized";
+const readReadmeFromDisk = async (lang) => {
+    const readmePath = path.join(process.cwd(), `README${(0, creatorUtilities_1.getReadmeExtension)(lang)}`);
     try {
-        const user = await api_1.default.validateToken(sessionPayload.token);
-        const assetTitle = getLocalizedValue(learnJson === null || learnJson === void 0 ? void 0 : learnJson.title, selectedLang);
-        const assetDescription = getLocalizedValue(learnJson === null || learnJson === void 0 ? void 0 : learnJson.description, selectedLang);
-        if (!assetTitle) {
-            throw new Error(`Missing learn.json title for language "${selectedLang}"`);
-        }
-        let slug = (0, creatorUtilities_1.slugify)(assetTitle).slice(0, 47);
-        slug = `${slug}-${selectedLang}`;
-        // Use pre-flight info when available to avoid an extra GET request
-        const { exists, academyId: existingAcademyId } = preflightInfo !== null && preflightInfo !== void 0 ? preflightInfo : (await api_1.default.doesAssetExists(sessionPayload.token, slug));
-        // const technologies: unknown[] = Array.isArray(learnJson?.technologies) ?
-        //   learnJson.technologies :
-        //   []
-        if (!exists) {
-            console_1.default.info("Asset does not exist in this academy, creating it");
-            const assetPayload = {
-                slug: slug,
-                title: assetTitle,
-                lang: selectedLang,
-                graded: true,
-                description: assetDescription,
-                learnpack_deploy_url: learnpackDeployUrl,
-                // technologies: technologies.map((tech: unknown) =>
-                //   String(tech).toLowerCase().replace(/\s+/g, "-")
-                // ),
-                technologies: [],
-                url: learnpackDeployUrl,
-                category: category,
-                owner: user.id,
-                author: user.id,
-                preview: learnJson.preview,
-                readme_raw: b64IndexReadme,
-                all_translations,
-                learnpack_id: learnpackId,
-            };
-            if (academyId !== undefined) {
-                assetPayload.academy_id = academyId;
-            }
-            const asset = await api_1.default.createAsset(sessionPayload.token, assetPayload);
-            try {
-                await api_1.default.updateRigoPackage(sessionPayload.rigobotToken.trim(), learnJson.slug, {
-                    asset_id: asset.id,
-                });
-            }
-            catch (error) {
-                console_1.default.error("Error updating Rigo package:", error);
-            }
-            console_1.default.info("Asset created with id", asset.id);
-            return asset;
-        }
-        console_1.default.info("Asset exists, updating it");
-        const updatePayload = {
-            graded: true,
-            learnpack_deploy_url: learnpackDeployUrl,
-            title: assetTitle,
-            category: category,
-            description: assetDescription,
-            all_translations,
-            learnpack_id: learnpackId,
-        };
-        // Only set academy when the asset has none yet and the user selected one
-        if (existingAcademyId === undefined && academyId !== undefined) {
-            updatePayload.academy_id = academyId;
-        }
-        const asset = await api_1.default.updateAsset(sessionPayload.token, slug, updatePayload);
-        try {
-            await api_1.default.updateRigoPackage(sessionPayload.rigobotToken.trim(), learnJson.slug, {
-                asset_id: asset.id,
-            });
-        }
-        catch (error) {
-            console_1.default.error("Error updating Rigo package:", error);
-        }
-        console_1.default.info("Asset updated with id", asset.id);
-        return asset;
+        return fs.existsSync(readmePath) ?
+            fs.readFileSync(readmePath, "utf-8") :
+            "";
     }
     catch (error) {
-        console_1.default.error("Error updating or creating asset:", error);
-        throw error;
+        console_1.default.error("Error reading index readme:", error);
+        return "";
     }
 };
-exports.handleAssetCreation = handleAssetCreation;
-const createMultiLangAssetFromDisk = async (sessionPayload, learnJson, deployUrl, selectedAcademyId, existingAssetsInfo = []) => {
-    const availableLangs = getAvailableLangs(learnJson);
-    if (availableLangs.length === 0) {
+const syncAssetsFromDisk = async (sessionPayload, learnJson, deployUrl, selectedAcademyId, resolution) => {
+    if ((0, assetResolver_1.getAvailableLangs)(learnJson).length === 0) {
         console_1.default.error("No languages found in learn.json.title. Add at least one language (e.g. title.en).");
         return;
     }
-    const learnpackId = await api_1.default.resolveLearnpackPackageId(sessionPayload.rigobotToken, learnJson.slug);
-    if (learnpackId === null) {
-        console_1.default.warning("Breathecode assets skipped: could not resolve Learnpack package id");
-        return;
+    // The pre-upload resolution is reused unless the package did not exist in
+    // Rigobot yet (first publish): the upload has just created it.
+    const result = await (0, assetSync_1.syncPackageAssets)({
+        bcToken: sessionPayload.token,
+        rigoToken: sessionPayload.rigobotToken,
+        packageSlug: learnJson.slug,
+        learnJson,
+        deployUrl,
+        academyId: selectedAcademyId,
+        readReadme: readReadmeFromDisk,
+        resolution: resolution.learnpackId === null ? undefined : resolution,
+    });
+    for (const warning of result.warnings)
+        console_1.default.warning(warning);
+    for (const synced of result.synced) {
+        console_1.default.info(`Asset ${synced.action} for "${synced.lang}": #${synced.asset.id} ${synced.asset.slug}`);
     }
-    const all_translations = [];
-    for (const lang of availableLangs) {
-        const readmePath = path.join(process.cwd(), `README${(0, creatorUtilities_1.getReadmeExtension)(lang)}`);
-        let indexReadmeString = "";
-        try {
-            if (fs.existsSync(readmePath)) {
-                indexReadmeString = fs.readFileSync(readmePath, "utf-8");
-            }
+    for (const error of result.errors) {
+        if (error.kind === "lang_error") {
+            console_1.default.error(`Asset for "${error.lang}": ${error.error.detail}`);
         }
-        catch (error) {
-            console_1.default.error("Error reading index readme:", error);
-            indexReadmeString = "";
-        }
-        const b64IndexReadme = Buffer.from(indexReadmeString).toString("base64");
-        const preflightInfo = existingAssetsInfo.find((a) => a.lang === lang);
-        try {
-            // eslint-disable-next-line no-await-in-loop
-            const asset = await (0, exports.handleAssetCreation)(sessionPayload, learnJson, lang, deployUrl, b64IndexReadme, selectedAcademyId, learnpackId, preflightInfo, all_translations);
-            if (!asset) {
-                console_1.default.debug("Could not create/update asset for lang", lang);
-                continue;
-            }
-            all_translations.push(asset.slug);
-        }
-        catch (error) {
-            console_1.default.error("Error creating asset for language", lang, error);
-            // Continue with other languages
+        else {
+            console_1.default.error(error.error.detail);
         }
     }
 };
@@ -313,8 +186,19 @@ class BuildCommand extends SessionCommand_1.default {
             process.exit(1);
         }
         console_1.default.info("Checking existing assets...");
-        const existingAssetsInfo = await getExistingAssetsInfo(sessionPayload.token, learnJson);
-        const academyMode = determinePublishAcademyMode(existingAssetsInfo);
+        const resolution = await (0, assetResolver_1.resolvePackageAssets)({
+            bcToken: sessionPayload.token,
+            rigoToken: rigoToken,
+            packageSlug: learnJson.slug,
+            learnJson,
+        });
+        for (const warning of resolution.warnings)
+            console_1.default.warning(warning);
+        if (resolution.packageState === "unknown") {
+            console_1.default.error(`${resolution.packageError}. Existing assets cannot be checked, so publishing now could create duplicates. Try again later.`);
+            process.exit(1);
+        }
+        const academyMode = (0, assetResolver_1.determineAcademyMode)(resolution);
         let selectedAcademyId;
         if (academyMode.type === "conflict") {
             console_1.default.warning(`Some of your assets are associated with different academies ` +
@@ -380,9 +264,9 @@ class BuildCommand extends SessionCommand_1.default {
         if (fs.existsSync(indexHtmlPath)) {
             let indexHtmlContent = fs.readFileSync(indexHtmlPath, "utf-8");
             const selectedLang = getDefaultLang(learnJson);
-            const description = getLocalizedValue(learnJson === null || learnJson === void 0 ? void 0 : learnJson.description, selectedLang) ||
+            const description = (0, assetSync_1.getLocalizedValue)(learnJson === null || learnJson === void 0 ? void 0 : learnJson.description, selectedLang) ||
                 "LearnPack is awesome!";
-            const title = getLocalizedValue(learnJson === null || learnJson === void 0 ? void 0 : learnJson.title, selectedLang) ||
+            const title = (0, assetSync_1.getLocalizedValue)(learnJson === null || learnJson === void 0 ? void 0 : learnJson.title, selectedLang) ||
                 "LearnPack: Interactive Learning as a Service";
             const previewUrl = learnJson.preview || (0, branding_1.getFallbackPreviewUrl)();
             // Replace placeholders and the <title>Old title </title> tag for a new tag with the title
@@ -402,9 +286,9 @@ class BuildCommand extends SessionCommand_1.default {
         if (fs.existsSync(manifestPWA)) {
             let manifestPWAContent = fs.readFileSync(manifestPWA, "utf-8");
             const selectedLang = getDefaultLang(learnJson);
-            const courseTitle = getLocalizedValue(learnJson === null || learnJson === void 0 ? void 0 : learnJson.title, selectedLang) ||
-                getLocalizedValue(learnJson === null || learnJson === void 0 ? void 0 : learnJson.title, "us") ||
-                getLocalizedValue(learnJson === null || learnJson === void 0 ? void 0 : learnJson.title, "en") ||
+            const courseTitle = (0, assetSync_1.getLocalizedValue)(learnJson === null || learnJson === void 0 ? void 0 : learnJson.title, selectedLang) ||
+                (0, assetSync_1.getLocalizedValue)(learnJson === null || learnJson === void 0 ? void 0 : learnJson.title, "us") ||
+                (0, assetSync_1.getLocalizedValue)(learnJson === null || learnJson === void 0 ? void 0 : learnJson.title, "en") ||
                 "LearnPack";
             manifestPWAContent = manifestPWAContent.replace("{{course_title}}", courseTitle);
             const courseShortName = { answer: "testing-tutorial" };
@@ -461,7 +345,7 @@ class BuildCommand extends SessionCommand_1.default {
                 console.log(res.data);
                 fs.unlinkSync(zipFilePath);
                 this.removeDirectory(buildDir);
-                await createMultiLangAssetFromDisk({ token: sessionPayload.token, rigobotToken: rigoToken }, learnJson, res.data.url, selectedAcademyId, existingAssetsInfo);
+                await syncAssetsFromDisk({ token: sessionPayload.token, rigobotToken: rigoToken }, learnJson, res.data.url, selectedAcademyId, resolution);
             }
             catch (error) {
                 if (axios_1.default.isAxiosError(error)) {

package/lib/commands/serve.js

@@ -31,7 +31,8 @@ const misc_1 = require("../utils/misc");
 const configBuilder_1 = require("../utils/configBuilder");
 const creatorUtilities_2 = require("../utils/creatorUtilities");
 const sidebarGenerator_1 = require("../utils/sidebarGenerator");
-const publish_1 = require("./publish");
+const assetResolver_1 = require("../utils/assetResolver");
+const assetSync_1 = require("../utils/assetSync");
 const export_1 = require("../utils/export");
 const router_1 = require("../services/ingest/http/router");
 const bucketIo_1 = require("../utils/coursePackage/bucketIo");
@@ -319,94 +320,34 @@ const cleanFormState = (formState) => {
 const cleanFormStateForSyllabus = (formState) => {
     return Object.assign(Object.assign({}, formState), { description: formState.description, technologies: formState.technologies, contentIndex: formState.contentIndex, purposse: undefined, duration: undefined, hasContentIndex: undefined, variables: undefined, currentStep: undefined, language: undefined, isCompleted: undefined });
 };
-const getLocalizedValue = (translations, lang, fallbackLangs = ["en", "us"]) => {
-    if (!translations || typeof translations !== "object")
-        return "";
-    const direct = translations[lang];
-    if (typeof direct === "string" && direct.trim().length > 0)
-        return direct;
-    for (const fb of fallbackLangs) {
-        const v = translations[fb];
-        if (typeof v === "string" && v.trim().length > 0)
-            return v;
-    }
-    const firstKey = Object.keys(translations)[0];
-    const first = firstKey ? translations[firstKey] : "";
-    return typeof first === "string" ? first : "";
-};
-function assetSyncErrorDetail(err) {
-    if (typeof (err === null || err === void 0 ? void 0 : err.detail) === "string")
-        return err.detail;
-    if (typeof (err === null || err === void 0 ? void 0 : err.message) === "string")
-        return err.message;
-    try {
-        return JSON.stringify(err);
-    }
-    catch (_a) {
-        return String(err);
-    }
-}
 const createMultiLangAsset = async (bucket, rigoToken, bcToken, courseSlug, courseJson, deployUrl, academyId) => {
-    var _a;
-    const learnpackId = await (0, api_1.resolveLearnpackPackageId)(rigoToken, courseSlug);
-    if (learnpackId === null) {
-        return {
-            errors: [
-                {
-                    kind: "package_error",
-                    error: {
-                        detail: "Could not resolve Learnpack package id; assets not synced to Breathecode.",
-                    },
-                },
-            ],
-        };
-    }
-    const availableLangs = Object.keys(courseJson.title);
-    console.log("AVAILABLE LANGUAGES to upload asset", availableLangs);
-    const all_translations = [];
-    const errors = [];
-    for (const lang of availableLangs) {
-        // eslint-disable-next-line no-await-in-loop
-        const indexReadme = await bucket.file(`courses/${courseSlug}/README${(0, creatorUtilities_1.getReadmeExtension)(lang)}`);
-        let indexReadmeString = "";
+    const readReadme = async (lang) => {
+        const indexReadme = bucket.file(`courses/${courseSlug}/README${(0, creatorUtilities_1.getReadmeExtension)(lang)}`);
         try {
-            // eslint-disable-next-line no-await-in-loop
-            const [indexReadmeContent] = await indexReadme.download();
-            indexReadmeString = indexReadmeContent.toString();
+            const [content] = await indexReadme.download();
+            return content.toString();
         }
         catch (error) {
             console.error("Error downloading index readme", error);
             // TODO: Trigger generation of the index readme
-            indexReadmeString = "";
-        }
-        const b64IndexReadme = buffer_1.Buffer.from(indexReadmeString).toString("base64");
-        try {
-            // eslint-disable-next-line no-await-in-loop
-            const asset = await (0, publish_1.handleAssetCreation)({ token: bcToken, rigobotToken: rigoToken.trim() }, courseJson, lang, deployUrl, b64IndexReadme, academyId, learnpackId, undefined, all_translations);
-            if (!asset) {
-                errors.push({
-                    kind: "lang_error",
-                    lang,
-                    error: { detail: "Failed to create asset" },
-                });
-                console.log("No se pudo crear el asset, saltando idioma", lang);
-                continue;
-            }
-            all_translations.push(asset.slug);
-        }
-        catch (error) {
-            const errorData = error && typeof error === "object" && "response" in error ?
-                ((_a = error.response) === null || _a === void 0 ? void 0 : _a.data) || error :
-                error;
-            errors.push({
-                kind: "lang_error",
-                lang,
-                error: { detail: assetSyncErrorDetail(errorData) },
-            });
-            console.error(`Error creating asset for language ${lang}:`, error);
+            return "";
         }
+    };
+    const result = await (0, assetSync_1.syncPackageAssets)({
+        bcToken,
+        rigoToken,
+        packageSlug: courseSlug,
+        learnJson: courseJson,
+        deployUrl,
+        academyId,
+        readReadme,
+    });
+    for (const warning of result.warnings)
+        console.warn("[assets]", warning);
+    for (const synced of result.synced) {
+        console.log(`[assets] ${synced.action} "${synced.lang}": #${synced.asset.id} ${synced.asset.slug}`);
     }
-    return { errors };
+    return { errors: result.errors };
 };
 const lessonCleaner = (lesson) => {
     return Object.assign(Object.assign({}, lesson), { duration: undefined, generated: undefined, status: undefined, translations: undefined, uid: undefined, initialContent: undefined, locked: undefined });
@@ -3713,52 +3654,47 @@ class ServeCommand extends SessionCommand_1.default {
                         error: "Authentication failed, missing breathecode token",
                     });
                 }
+                // Older IDEs only send the Breathecode token; without the Rigobot
+                // token the lookup falls back to the title-derived slugs.
+                const rigoToken = req.header("x-rigo-token");
                 const configFile = await bucket.file(`courses/${slug}/.learn/config.json`);
                 const [configContent] = await configFile.download();
                 const configJson = JSON.parse(configContent.toString());
                 const { config } = configJson;
-                const availableLangs = Object.keys(config.title || {});
-                let isPublished = false;
-                // Collect academy ids from all existing assets
-                const foundAcademyIds = [];
-                const slugsToCheck = availableLangs
-                    .map(lang => {
-                    const assetTitle = getLocalizedValue(config.title, lang);
-                    if (!assetTitle)
-                        return null;
-                    const assetSlug = (0, creatorUtilities_2.slugify)(assetTitle).slice(0, 47);
-                    return `${assetSlug}-${lang}`;
-                })
-                    .filter((slug) => slug !== null);
-                const assetChecks = await Promise.all(slugsToCheck.map(slug => (0, api_1.doesAssetExists)(bcToken, slug)));
-                for (const { exists, academyId: existingAcademyId } of assetChecks) {
-                    if (exists) {
-                        isPublished = true;
-                        if (existingAcademyId !== undefined) {
-                            foundAcademyIds.push(existingAcademyId);
-                        }
+                const resolution = await (0, assetResolver_1.resolvePackageAssets)({
+                    bcToken,
+                    rigoToken,
+                    packageSlug: slug,
+                    learnJson: config,
+                });
+                for (const warning of resolution.warnings) {
+                    console.warn("[package-academy]", warning);
+                }
+                const isPublished = (0, assetResolver_1.hasPublishedAsset)(resolution);
+                const academyMode = (0, assetResolver_1.determineAcademyMode)(resolution);
+                const warnings = [...resolution.warnings];
+                if (resolution.packageState === "unknown") {
+                    warnings.push(`${resolution.packageError}; existing assets could not be checked.`);
+                }
+                for (const [lang, entry] of resolution.byLang) {
+                    if (entry.status === "unknown") {
+                        warnings.push(`"${lang}": ${entry.error}`);
+                    }
+                    else if (entry.status === "ambiguous") {
+                        warnings.push(`"${lang}": ${entry.candidates.length} assets found (${entry.candidates
+                            .map(c => `#${c.id} ${c.slug}`)
+                            .join(", ")})`);
                     }
                 }
-                const uniqueAcademies = [...new Set(foundAcademyIds)];
-                let mode;
-                let lockedAcademyId;
-                let conflictAcademies;
-                if (uniqueAcademies.length === 0) {
-                    mode = "select";
-                }
-                else if (uniqueAcademies.length === 1) {
-                    mode = "locked";
-                    lockedAcademyId = uniqueAcademies[0];
-                }
-                else {
-                    mode = "conflict";
-                    conflictAcademies = uniqueAcademies;
-                }
+                const mode = academyMode.type;
+                const lockedAcademyId = academyMode.type === "locked" ? academyMode.academyId : undefined;
+                const conflictAcademies = academyMode.type === "conflict" ? academyMode.academies : undefined;
                 return res.json({
                     isPublished,
                     mode,
                     lockedAcademyId,
                     conflictAcademies,
+                    warnings,
                 });
             }
             catch (error) {

package/lib/utils/api.d.ts

@@ -1,3 +1,4 @@
+export declare const BREATHECODE_HOST = "https://breathecode.herokuapp.com";
 /**
  * Student telemetry, and publication events. Both share the endpoint: a body
  * carrying a top-level `event` key is dispatched as an event, anything else
@@ -31,13 +32,30 @@ export type AssetSyncError = {
         detail: string;
     };
 };
+export type RigoPackageLookup = {
+    kind: "found";
+    id: number;
+    assetIds: number[];
+} | {
+    kind: "missing";
+} | {
+    kind: "error";
+    error: string;
+};
 /**
- * GET Rigobot package by slug after a successful upload. Does not throw.
- * @param rigoToken Rigobot API token (Bearer-style `Token` header value).
+ * Human-readable summary of a failed axios call, for warnings and error payloads.
+ * @param error - Whatever the request rejected with.
+ * @returns "HTTP <status>" when the server answered, the error message otherwise.
+ */
+export declare function describeRequestError(error: unknown): string;
+/**
+ * GET a Rigobot package by slug. Distinguishes "no such package" from
+ * "could not check", so callers can fail closed on the latter.
+ * @param rigoToken Rigobot API token (`Token` header value).
  * @param courseSlug Learnpack package slug used in the Rigobot URL path.
- * @returns Resolved numeric package id from Rigobot, or `null` if the request fails, the id is missing, or it is not a finite integer.
+ * @returns The package id and its asset_ids, `missing` on 404, `error` otherwise (403 included: a package owned by somebody else is not ours to read).
  */
-export declare function resolveLearnpackPackageId(rigoToken: string, courseSlug: string): Promise<number | null>;
+export declare function getRigoPackage(rigoToken: string, courseSlug: string): Promise<RigoPackageLookup>;
 type TAssetMissing = {
     slug: string;
     title: string;
@@ -57,10 +75,41 @@ type TAssetMissing = {
     learnpack_id: number;
 };
 export declare const createAsset: (token: string, asset: TAssetMissing) => Promise<any>;
-export declare const doesAssetExists: (token: string, assetSlug: string) => Promise<{
-    exists: boolean;
-    academyId?: number;
-}>;
+/** The subset of a Breathecode asset the publish flow reads. */
+export type BcAsset = {
+    id: number;
+    slug: string;
+    lang: string | null;
+    status: string | null;
+    learnpackId: number | null;
+    learnpackDeployUrl: string | null;
+    ownerId: number | null;
+    academyId: number | null;
+};
+export type AssetLookup = {
+    kind: "found";
+    asset: BcAsset;
+} | {
+    kind: "missing";
+} | {
+    kind: "error";
+    error: string;
+};
+/**
+ * GET a Breathecode asset by numeric id. The endpoint applies no status or
+ * visibility filter for a single asset, so this is the stable anchor.
+ * @param token Breathecode token.
+ * @param assetId Asset primary key.
+ * @returns `found` with the asset, `missing` on 404, `error` when it could not be checked.
+ */
+export declare const getAssetById: (token: string, assetId: number) => Promise<AssetLookup>;
+/**
+ * GET a Breathecode asset by slug.
+ * @param token Breathecode token.
+ * @param assetSlug Asset slug.
+ * @returns `found` with the asset, `missing` on 404, `error` when it could not be checked.
+ */
+export declare const getAssetBySlug: (token: string, assetSlug: string) => Promise<AssetLookup>;
 type TTechnology = {
     slug: string;
     lang: string;
@@ -83,18 +132,16 @@ declare const _default: {
     listUserAcademies: (breathecodeToken: string) => Promise<TAcademy[]>;
     validateToken: (token: string) => Promise<any>;
     createAsset: (token: string, asset: TAssetMissing) => Promise<any>;
-    doesAssetExists: (token: string, assetSlug: string) => Promise<{
-        exists: boolean;
-        academyId?: number;
-    }>;
-    updateAsset: (token: string, assetSlug: string, asset: Partial<TAssetMissing> & {
+    getAssetById: (token: string, assetId: number) => Promise<AssetLookup>;
+    getAssetBySlug: (token: string, assetSlug: string) => Promise<AssetLookup>;
+    updateAsset: (token: string, assetId: number, asset: Partial<TAssetMissing> & {
         learnpack_id: number;
     }) => Promise<any>;
-    resolveLearnpackPackageId: typeof resolveLearnpackPackageId;
+    getRigoPackage: typeof getRigoPackage;
     getCategories: (token: string) => Promise<any>;
     updateRigoPackage: (token: string, slug: string, updates: {
         asset_id?: number;
-        new_slug?: string;
+        asset_ids?: number[];
     }) => Promise<any>;
     createRigoPackage: (token: string, slug: string, config: any) => Promise<any>;
     getCurrentTechnologies: () => TTechnology[];