@apimatic/cli 1.5.0 → 2.0.0-beta.2

package/lib/types/portal/content-tree.js

@@ -0,0 +1,344 @@
+import { getSlugs } from 'fumadocs-core/source/plugins/slugs';
+import { err, ok } from 'neverthrow';
+import { Directory } from '../file/directory.js';
+import { FileName } from '../file/fileName.js';
+import { FilePath } from '../file/filePath.js';
+import { GENERATED_SECTIONS } from './generated-pages.js';
+import { API_REFERENCE_NAME, GROUP_FOLDER, INDEX_NAME, NAVIGATION_FILE_NAME, PortalNavigation } from './portal-navigation.js';
+import { sharedTabNames, untitledTabName } from './portal-tabs.js';
+const NAVIGATION_FILE = new FileName(NAVIGATION_FILE_NAME);
+/** Extensions the docs collection compiles, and so the ones an entry can address. */
+const PAGE_EXTENSIONS = ['.md', '.mdx'];
+/** Passed over by Vite's `import.meta.glob`, which the build reads the content through. */
+export const isSkippedByGlob = (name) => name.startsWith('.') || name === 'node_modules';
+/** Whether the glob passes over `file` below `root`, which it does for a path with any such segment. */
+export const isSkippedWithin = (file, root) => file.relativeTo(root).split('/').some(isSkippedByGlob);
+/**
+ * The `content/` directory of a portal source, held to the rules the build reads it by. It reads
+ * nothing itself: `pages` and `navigationFiles` name what `check` needs to be handed.
+ */
+export class ContentTree {
+    tree;
+    sourceDirectory;
+    constructor(tree, 
+    /** What each file is named relative to, in the messages. */
+    sourceDirectory) {
+        this.tree = tree;
+        this.sourceDirectory = sourceDirectory;
+    }
+    /** The pages the build compiles. */
+    pages() {
+        return this.contentPages().map(({ file }) => file);
+    }
+    /** The `nav.json` files the build reads, which its glob matches by code point. */
+    navigationFiles() {
+        return this.tree
+            .getAllFiles()
+            .filter((file) => file.name().compare(NAVIGATION_FILE) === 0 && !this.isSkipped(file));
+    }
+    /** Whether the build would read `file` as part of `content/`: below it, and not passed over. */
+    holds(file) {
+        return this.tree.directoryPath.contains(file.directory()) && !this.isSkipped(file);
+    }
+    /** Every problem a build would refuse the tree for, or what it would warn of, from what it is handed. */
+    check(read, specs, generatedPages) {
+        const pages = this.contentPages();
+        const addressProblems = ContentTree.addressProblems(pages);
+        // The build fails as a whole over one page whose front matter it refuses, or one image it cannot import.
+        const { titled, errors: frontMatterErrors } = this.titledPages(read.pages);
+        const problems = [];
+        if (frontMatterErrors.length > 0) {
+            problems.push({ kind: 'invalidFrontMatter', errors: frontMatterErrors });
+        }
+        if (read.missingImages.length > 0) {
+            problems.push({ kind: 'missingImages', images: read.missingImages });
+        }
+        // The walk takes each page to be served where it sits, so it would misjudge an entry naming one of these.
+        if (addressProblems.length > 0) {
+            return err([...addressProblems, ...problems]);
+        }
+        // Validated here rather than in the template: Fumadocs drops an entry it cannot resolve
+        // without a word, so a typo would otherwise reach the user as a quietly wrong sidebar.
+        const navigation = this.navigation(read.navigationFiles, specs);
+        if (navigation.root.errors.length > 0) {
+            problems.push({ kind: 'invalidNavigation', errors: navigation.root.errors });
+        }
+        if (problems.length > 0) {
+            return err(problems);
+        }
+        const tabs = ContentTree.tabs(navigation.root, titled, generatedPages);
+        return ok({
+            hiddenPages: ContentTree.hiddenPages(pages, specs),
+            ignoredNavigationFiles: navigation.ignoredFiles,
+            folderTabs: tabs.flatMap(({ owner }) => (owner.kind === 'folder' ? [owner.directory] : [])),
+            sharedTabNames: sharedTabNames(tabs)
+        });
+    }
+    contentPages() {
+        return this.tree
+            .getAllFiles()
+            .filter((file) => pageName(file.name()) !== undefined && !this.isSkipped(file))
+            .map((file) => ({ file, segments: file.relativeTo(this.tree.directoryPath).split('/') }));
+    }
+    isSkipped(file) {
+        return isSkippedWithin(file, this.tree.directoryPath);
+    }
+    /** Every page the build accepts with its title, and what it would refuse in the front matter of the rest. */
+    titledPages(pages) {
+        const read = pages.map(({ file, parsed }) => {
+            const frontMatter = parsed?.frontMatter ?? err([`${file.relativeTo(this.sourceDirectory)} could not be read.`]);
+            return frontMatter.map(({ title }) => ({ file, title }));
+        });
+        return {
+            titled: read.flatMap((page) => (page.isOk() ? [page.value] : [])),
+            errors: read.flatMap((page) => (page.isErr() ? page.error : []))
+        };
+    }
+    /**
+     * Every `nav.json` in the tree, validated against the directory it orders, plus any `nav.json`
+     * in a case the build does not match. One walk, because both come from the same tree, and a
+     * directory has to be seen before its file can be checked against it.
+     */
+    navigation(navigationFiles, specs) {
+        const walk = new NavigationWalk(navigationFiles, specs, this.sourceDirectory);
+        return { root: walk.visit(this.tree, true, false), ignoredFiles: walk.ignoredFiles };
+    }
+    /**
+     * Every tab, named as the template names it, in the order a report lists them: Home, the
+     * folders the root `nav.json` lists, the generated sections, then the API reference.
+     */
+    static tabs(root, pages, generatedPages) {
+        const named = (owner, scan) => ContentTree.namedTab(owner, scan?.navigation, scan?.indexPage, pages);
+        // The home page is the content root's index page, which names no tab.
+        const home = ContentTree.namedTab({ kind: 'home' }, root.navigation, undefined, pages);
+        const folders = (root.navigation?.settings.pages ?? []).flatMap((entry) => {
+            const subfolder = entry === API_REFERENCE_NAME ? undefined : root.subfolders.get(entry);
+            return subfolder === undefined ? [] : [named({ kind: 'folder', directory: subfolder.directory }, subfolder.scan)];
+        });
+        const generated = generatedPages.sections().map((section) => named({ kind: 'generated', section }, undefined));
+        const reference = named({ kind: 'apiReference' }, root.subfolders.get(API_REFERENCE_NAME)?.scan);
+        return [home, ...folders, ...generated, reference];
+    }
+    /** A tab by the name the template gives it: its `nav.json` title, else its index page's. */
+    static namedTab(owner, navigation, indexPage, pages) {
+        if (navigation?.settings.title !== undefined) {
+            return { owner, name: navigation.settings.title, namedBy: navigation.file };
+        }
+        const index = indexPage === undefined ? undefined : pages.find((page) => page.file.isEqual(indexPage));
+        if (index !== undefined) {
+            return { owner, name: index.title, namedBy: index.file };
+        }
+        return { owner, name: untitledTabName(owner), namedBy: null };
+    }
+    /**
+     * Pages the build cannot serve where they are, each refused for one reason: a page with no
+     * address is not judged by one, and one at an address kept for the generated pages is not
+     * said to share it as well.
+     */
+    static addressProblems(pages) {
+        const problems = [];
+        // Fumadocs throws on one: a `(group)` name is left out of every address, so it has none.
+        const groupNamed = pages.filter(({ file }) => GROUP_FOLDER.test(pageName(file.name()) ?? ''));
+        if (groupNamed.length > 0) {
+            problems.push({ kind: 'groupNamedPages', pages: groupNamed.map(({ file }) => file) });
+        }
+        const addressed = pages.filter((page) => !groupNamed.includes(page));
+        // In the build, the user's page and the generated one would compete for the address.
+        const reserved = ContentTree.reservedAddressPages(addressed);
+        if (reserved.length > 0) {
+            problems.push({ kind: 'reservedAddresses', pages: reserved });
+        }
+        // The build fails on two pages at one address, or moves an index page to `<folder>/index`.
+        const shared = ContentTree.sharedAddresses(addressed.filter(({ file }) => !reserved.some((page) => page.file.isEqual(file))));
+        if (shared.length > 0) {
+            problems.push({ kind: 'sharedAddresses', addresses: shared });
+        }
+        return problems;
+    }
+    /**
+     * Pages served at a generated section's address or below it, whether or not `apimatic.json`
+     * calls for the section. Judged by the address, as the content source computes it, rather
+     * than by the directories as written: a page in a `(group)` folder is served as if the folder
+     * were not there, and a folder's index page at the folder's own address.
+     */
+    static reservedAddressPages(pages) {
+        return pages.flatMap(({ file, segments }) => {
+            const slugs = getSlugs(segments.join('/'));
+            const section = GENERATED_SECTIONS.find((candidate) => candidate.folder === slugs[0]);
+            return section === undefined ? [] : [{ file, address: `/${slugs.join('/')}`, section }];
+        });
+    }
+    /** Addresses more than one page would be served at, each with its pages in the order walked. */
+    static sharedAddresses(pages) {
+        const byAddress = new Map();
+        for (const { file, segments } of pages) {
+            const address = `/${getSlugs(segments.join('/')).join('/')}`;
+            byAddress.set(address, [...(byAddress.get(address) ?? []), file]);
+        }
+        return [...byAddress]
+            .filter(([, files]) => files.length > 1)
+            .map(([address, files]) => ({ address, pages: files }));
+    }
+    /**
+     * Pages inside a specification's section, below `content/api/<slug>/`. The section and each
+     * tag folder come with generated metadata that lists only the reference pages, and metadata
+     * hides whatever it does not name, so these pages never reach the sidebar. Reported rather
+     * than refused: the build still succeeds, and the fix is to move the page.
+     *
+     * Judged by the directories as written, not by the address: the page tree is keyed on the
+     * path, so `content/API/<slug>/` or a `(group)` folder on the way is a different folder that
+     * no metadata hides. An `index` page is a folder's own link rather than one of its pages, so
+     * the section's is shown, and so is one in a folder directly below it: that is where the tag
+     * folders sit, and the CLI cannot tell a tag folder from one the user made without reading
+     * the specification's tags, so it stays quiet rather than warn about a page that is shown.
+     */
+    static hiddenPages(pages, specs) {
+        const slugs = new Set(specs.map((spec) => spec.slug));
+        return pages
+            .filter(({ segments }) => {
+            const [first, second, ...rest] = segments;
+            const last = rest.at(-1);
+            if (first !== API_REFERENCE_NAME || !slugs.has(second) || last === undefined) {
+                return false;
+            }
+            const isFolderIndex = rest.length <= 2 && pageName(new FileName(last)) === INDEX_NAME;
+            return !isFolderIndex;
+        })
+            .map(({ file }) => file);
+    }
+}
+/**
+ * The name an entry addresses a page by, which is its file's without the extension, or undefined
+ * when the file is not a page. By code point, like the docs glob: `Guide.MD` is no page to either.
+ */
+function pageName(fileName) {
+    return PAGE_EXTENSIONS.some((extension) => fileName.hasExactExtension(extension))
+        ? `${fileName.withoutExtension()}`
+        : undefined;
+}
+/**
+ * The walk of `ContentTree.navigation`. Children first, because a directory counts as one of its
+ * parent's children only when a page sits somewhere beneath it, and each directory's errors go
+ * ahead of its children's, so the report still reads top down.
+ */
+class NavigationWalk {
+    navigationFiles;
+    specs;
+    sourceDirectory;
+    ignoredFiles = [];
+    constructor(navigationFiles, specs, sourceDirectory) {
+        this.navigationFiles = navigationFiles;
+        this.specs = specs;
+        this.sourceDirectory = sourceDirectory;
+    }
+    visit(directory, isContentRoot, isApiDirectory) {
+        const listing = NavigationWalk.listing(directory);
+        this.ignoredFiles.push(...listing.ignoredFiles);
+        const entries = listing.entries.map((entry) => 'folder' in entry ? this.walk(entry.folder, isContentRoot) : entry);
+        const folders = entries.flatMap((entry) => ('scan' in entry ? [entry] : []));
+        const pages = entries.flatMap((entry) => ('page' in entry ? [entry] : []));
+        const holdsPage = pages.length > 0 || folders.some(({ scan }) => scan.holdsPage);
+        const indexPage = pages.find(({ page }) => page === INDEX_NAME)?.file;
+        const servingThisAddress = folders
+            .filter(({ name, scan }) => scan.servesOwnAddress && GROUP_FOLDER.test(name))
+            .map(({ name }) => name);
+        // A directory with no page anywhere beneath it becomes no node in the page tree, so naming it
+        // would resolve to nothing. Fumadocs would build one for a directory that holds only a
+        // `nav.json`, but the template drops it again to keep to this rule.
+        const childNames = entries.flatMap((entry) => {
+            if ('page' in entry) {
+                return [entry.page];
+            }
+            return entry.scan.holdsPage && !entry.isApiChild ? [entry.name] : [];
+        });
+        const { errors, navigation } = this.checkedNavigation(listing.navigationFile, {
+            isContentRoot,
+            isApiDirectory,
+            // The reference's own directory is a folder in the sidebar however few pages the user
+            // keeps in it, because the specification sections are mounted there.
+            becomesFolder: holdsPage || isApiDirectory,
+            childNames: this.withMountedChildren(childNames, pages, isContentRoot, isApiDirectory),
+            emptyFolders: folders.filter(({ scan, isApiChild }) => !scan.holdsPage && !isApiChild).map(({ name }) => name),
+            // At the content root, the address such a folder serves is the home page's.
+            homePageFolders: isContentRoot ? servingThisAddress : []
+        });
+        return {
+            holdsPage,
+            servesOwnAddress: indexPage !== undefined || servingThisAddress.length > 0,
+            navigation,
+            indexPage,
+            subfolders: new Map(folders
+                .filter(({ scan, isApiChild }) => scan.holdsPage || isApiChild)
+                .map((folder) => [folder.name, { directory: folder.directory, scan: folder.scan }])),
+            errors: [...errors, ...folders.flatMap(({ scan }) => scan.errors)]
+        };
+    }
+    walk(folder, parentIsContentRoot) {
+        const name = folder.directoryPath.leafName();
+        const isApiChild = parentIsContentRoot && name === API_REFERENCE_NAME;
+        return { name, directory: folder.directoryPath, isApiChild, scan: this.visit(folder, false, isApiChild) };
+    }
+    /** The children an entry can name that no directory of the user's holds: the reference's. */
+    withMountedChildren(childNames, pages, isContentRoot, isApiDirectory) {
+        // The reference is mounted at `content/api` whether or not a directory is there to see, so it
+        // is a child of the content root in every portal, and one entry gets one answer whatever else
+        // shares the directory. A page of that name is a second child, and the clash is what says it
+        // can never be positioned.
+        if (isContentRoot) {
+            return [...childNames, API_REFERENCE_NAME];
+        }
+        if (!isApiDirectory) {
+            return childNames;
+        }
+        // The reference pages are mounted here, one folder per specification. A directory of the same
+        // name is that very folder, so it is not listed twice; a page of the same name is a second
+        // child, and listed again so the validator sees the clash.
+        const names = [...childNames];
+        for (const { slug } of this.specs) {
+            if (!names.includes(slug) || pages.some(({ page }) => page === slug)) {
+                names.push(slug);
+            }
+        }
+        return names;
+    }
+    checkedNavigation(file, context) {
+        if (file === undefined) {
+            return { errors: [], navigation: undefined };
+        }
+        const label = file.relativeTo(this.sourceDirectory);
+        // An empty file goes through too: the build parses it as JSON and fails on it.
+        const contents = this.navigationFiles.find((read) => read.file.isEqual(file))?.contents;
+        if (contents === undefined) {
+            return { errors: [`${label} could not be read.`], navigation: undefined };
+        }
+        const checked = PortalNavigation.validate(contents, { label, ...context });
+        return checked.isErr()
+            ? { errors: checked.error, navigation: undefined }
+            : { errors: [], navigation: { file, settings: checked.value } };
+    }
+    static listing(directory) {
+        const listing = { entries: [], navigationFile: undefined, ignoredFiles: [] };
+        for (const item of directory.items) {
+            if (item instanceof Directory) {
+                if (!isSkippedByGlob(item.directoryPath.leafName())) {
+                    listing.entries.push({ folder: item });
+                }
+            }
+            else if (!isSkippedByGlob(item.fileName.toString())) {
+                const file = new FilePath(directory.directoryPath, item.fileName);
+                const page = pageName(item.fileName);
+                if (item.fileName.compare(NAVIGATION_FILE) === 0) {
+                    listing.navigationFile = file;
+                }
+                else if (item.fileName.is(NAVIGATION_FILE_NAME)) {
+                    listing.ignoredFiles.push(file);
+                }
+                else if (page !== undefined) {
+                    listing.entries.push({ page, file });
+                }
+            }
+        }
+        return listing;
+    }
+}
+//# sourceMappingURL=content-tree.js.map

package/lib/types/portal/content-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-tree.js","sourceRoot":"","sources":["../../../src/types/portal/content-tree.ts"],"names":[],"mappings":"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"}

package/lib/types/portal/endpoint.d.ts

@@ -0,0 +1,6 @@
+export declare class Endpoint {
+    readonly path: string;
+    readonly method: string;
+    constructor(method: string, path: string);
+    toString(): string;
+}

package/lib/types/portal/endpoint.js

@@ -0,0 +1,12 @@
+export class Endpoint {
+    path;
+    method;
+    constructor(method, path) {
+        this.path = path;
+        this.method = method.toUpperCase();
+    }
+    toString() {
+        return `${this.method} ${this.path}`;
+    }
+}
+//# sourceMappingURL=endpoint.js.map

package/lib/types/portal/endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.js","sourceRoot":"","sources":["../../../src/types/portal/endpoint.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,QAAQ;IAGyB,IAAI;IAFhC,MAAM,CAAS;IAE/B,YAAY,MAAc,EAAkB,IAAY;oBAAZ,IAAI;QAC9C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACrC,CAAC;IAEM,QAAQ;QACb,OAAO,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;IACvC,CAAC;CACF"}

package/lib/types/portal/generated-pages.d.ts

@@ -0,0 +1,68 @@
+import { FileName } from '../file/fileName.js';
+import { UrlPath } from '../file/urlPath.js';
+import { Language } from '../sdk/generate.js';
+import { PageValues } from './page-template.js';
+import { PortalArtifacts } from './portal-artifacts.js';
+import { PortalLanguages } from './portal-languages.js';
+export declare const GENERATED_DIRECTORY_NAME = "generated";
+/** A set of pages the CLI writes into the portal, which the portal shows as a tab of its own. */
+export interface GeneratedSection {
+    /** The folder the pages are written to, and so the address they are served at. */
+    folder: string;
+    /** The root `nav.json` entry that positions the tab. */
+    token: string;
+    title: string;
+    /** What a message says the address is kept for. */
+    description: string;
+}
+export declare const SDK_SECTION: GeneratedSection;
+export declare const PLUGIN_SECTION: GeneratedSection;
+/** Every section, in the order the tabs take when the root `nav.json` names none of them. */
+export declare const GENERATED_SECTIONS: readonly GeneratedSection[];
+/** The templates in the package's `portal-pages/` directory, by the name of their file. */
+export declare const PAGE_TEMPLATES: readonly ['sdks', 'sdk', 'context-plugin'];
+export type PageTemplateName = (typeof PAGE_TEMPLATES)[number];
+/** A page to render from one of the templates and write into a section's folder. */
+export interface GeneratedPage {
+    section: GeneratedSection;
+    fileName: FileName;
+    template: PageTemplateName;
+    data: PageValues;
+}
+/** A hosted plugin is installed from `portal.pluginUrl`, and the portal artifacts carry none. */
+export type PluginSource = {
+    kind: 'bundled';
+} | {
+    kind: 'hosted';
+    url: UrlPath;
+};
+/** What the pages link to or include that the portal artifacts did not deliver. */
+export interface MissingArtifacts {
+    sdks: Language[];
+    sdkDocs: Language[];
+    /** Whether the plugin the page installs from the portal is not among them. */
+    plugin: boolean;
+}
+/** A section's `nav.json`, which names its tab and orders its pages. */
+export interface GeneratedNavigation {
+    section: GeneratedSection;
+    contents: string;
+}
+/**
+ * The pages `apimatic.json` calls for: the SDKs page and one page per language, in the order
+ * the `languages` block lists them, and the context plugin page when there is a plugin to install.
+ */
+export declare class GeneratedPages {
+    private readonly sdks;
+    private readonly plugin;
+    private constructor();
+    static of(languages: PortalLanguages, plugin: PluginSource | null): GeneratedPages;
+    sections(): GeneratedSection[];
+    /** Whatever pages the tabs hold, which the languages decide. */
+    makesSameTabsAs(other: GeneratedPages): boolean;
+    pages(): GeneratedPage[];
+    navigationFiles(): GeneratedNavigation[];
+    /** Null when the artifacts back every page; a page backed by nothing fails the build or links nowhere. */
+    missingFrom(artifacts: PortalArtifacts): MissingArtifacts | null;
+    private pluginPage;
+}

package/lib/types/portal/generated-pages.js

@@ -0,0 +1,111 @@
+import { posix } from 'node:path';
+import { FileName } from '../file/fileName.js';
+import { LANGUAGE_NAMES } from '../sdk/generate.js';
+import { sdkDocsPath } from './page-fragments.js';
+import { PLUGIN_DOWNLOAD_ADDRESS, sdkDownloadAddress } from './portal-downloads.js';
+// `src/lib/source.ts` names it as a relative literal, so the browser bundle never carries the project's location.
+export const GENERATED_DIRECTORY_NAME = 'generated';
+export const SDK_SECTION = {
+    folder: 'sdks',
+    token: 'apimatic:sdks',
+    title: 'SDKs',
+    description: 'the SDK pages'
+};
+const SDK_PAGES_DIRECTORY = posix.join(GENERATED_DIRECTORY_NAME, SDK_SECTION.folder);
+export const PLUGIN_SECTION = {
+    folder: 'context-plugin',
+    token: 'apimatic:plugin',
+    title: 'Context Plugin',
+    description: 'the context plugin page'
+};
+/** Every section, in the order the tabs take when the root `nav.json` names none of them. */
+export const GENERATED_SECTIONS = [SDK_SECTION, PLUGIN_SECTION];
+/** The templates in the package's `portal-pages/` directory, by the name of their file. */
+export const PAGE_TEMPLATES = ['sdks', 'sdk', 'context-plugin'];
+const INDEX_PAGE = new FileName('index.mdx');
+/**
+ * The pages `apimatic.json` calls for: the SDKs page and one page per language, in the order
+ * the `languages` block lists them, and the context plugin page when there is a plugin to install.
+ */
+export class GeneratedPages {
+    sdks;
+    plugin;
+    constructor(sdks, plugin) {
+        this.sdks = sdks;
+        this.plugin = plugin;
+    }
+    static of(languages, plugin) {
+        return new GeneratedPages(languages.listed(), plugin);
+    }
+    sections() {
+        return this.plugin === null ? [SDK_SECTION] : [SDK_SECTION, PLUGIN_SECTION];
+    }
+    /** Whatever pages the tabs hold, which the languages decide. */
+    makesSameTabsAs(other) {
+        const theirs = other.sections();
+        const mine = this.sections();
+        return mine.length === theirs.length && mine.every((section, index) => section === theirs[index]);
+    }
+    pages() {
+        const languagePages = this.sdks.map((sdk) => ({
+            section: SDK_SECTION,
+            fileName: new FileName(`${sdk.language}.mdx`),
+            template: 'sdk',
+            data: { ...card(sdk), docs: posix.relative(SDK_PAGES_DIRECTORY, sdkDocsPath(sdk.language)) }
+        }));
+        return [
+            { section: SDK_SECTION, fileName: INDEX_PAGE, template: 'sdks', data: { sdks: this.sdks.map(card) } },
+            ...languagePages,
+            ...(this.plugin === null ? [] : [this.pluginPage(this.plugin)])
+        ];
+    }
+    // The index page is the folder's own link rather than one of its pages, so no file names it.
+    navigationFiles() {
+        return this.sections().map((section) => ({
+            section,
+            contents: `${JSON.stringify(section === SDK_SECTION
+                ? { title: section.title, pages: this.sdks.map((sdk) => sdk.language) }
+                : { title: section.title }, null, 2)}\n`
+        }));
+    }
+    /** Null when the artifacts back every page; a page backed by nothing fails the build or links nowhere. */
+    missingFrom(artifacts) {
+        const languages = this.sdks.map((sdk) => sdk.language);
+        const sdks = languages.filter((language) => !artifacts.sdks.has(language));
+        const sdkDocs = languages.filter((language) => !artifacts.sdkDocs.has(language));
+        const plugin = this.plugin?.kind === 'bundled' && artifacts.plugin === undefined;
+        return sdks.length > 0 || sdkDocs.length > 0 || plugin ? { sdks, sdkDocs, plugin } : null;
+    }
+    // Every language the portal supports can be carried by a plugin, so the page lists them all.
+    pluginPage(plugin) {
+        return {
+            section: PLUGIN_SECTION,
+            fileName: INDEX_PAGE,
+            template: 'context-plugin',
+            data: {
+                installPath: plugin.kind === 'hosted' ? attribute(plugin.url) : PLUGIN_DOWNLOAD_ADDRESS,
+                languages: this.sdks.map((sdk) => ({ language: sdk.language, name: LANGUAGE_NAMES[sdk.language] }))
+            }
+        };
+    }
+}
+/** Every field is present, empty when nothing is recorded, so a template's attribute list is fixed. */
+function card(sdk) {
+    const published = sdk.publishedPackage();
+    const source = sdk.sourceRepository();
+    return {
+        language: sdk.language,
+        name: LANGUAGE_NAMES[sdk.language],
+        page: `/${SDK_SECTION.folder}/${sdk.language}`,
+        download: sdkDownloadAddress(sdk.language),
+        source: source === null ? '' : attribute(source),
+        install: published === null ? '' : attribute(published.install),
+        packageUrl: published === null ? '' : attribute(published.url),
+        registry: published === null ? '' : published.registry
+    };
+}
+// A double-quoted JSX attribute, whose entities MDX decodes: `&` first, so an `&` in a value survives.
+function attribute(value) {
+    return `${value}`.replaceAll('&', '&').replaceAll('"', '"');
+}
+//# sourceMappingURL=generated-pages.js.map

package/lib/types/portal/generated-pages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated-pages.js","sourceRoot":"","sources":["../../../src/types/portal/generated-pages.ts"],"names":[],"mappings":"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"}

package/lib/types/portal/generation-status.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The statuses `/portal-artifacts` reports. Modelled in full, for the reason the plugin's own
+ * vocabulary is: a status this CLI does not name is indistinguishable from one it does, and the
+ * polling loop decides whether to wait, stop or fail on exactly this value.
+ *
+ * Two differences from `PluginGenerationStatus`, both worth knowing when reading the poll:
+ *
+ * - `SubscriptionError` is reported here. A run refused for the endpoint itself is a 403 on the
+ *   initiate call, but a run refused for *what it asked for* — a language or a context plugin the
+ *   subscription does not carry — is decided inside the orchestrator and comes back as a status.
+ * - `Completed` is never sent on the wire. Like the plugin's status endpoint, this one redirects
+ *   to the download when a run finishes, so the 302 is what the poll reads as success. The value
+ *   is named here because the poll needs one to report.
+ */
+export declare enum PortalArtifactsGenerationStatus {
+    Queued = "Queued",
+    ExecutionStarted = "ExecutionStarted",
+    GeneratingArtifacts = "GeneratingArtifacts",
+    Completed = "Completed",
+    Failed = "Failed",
+    ValidationError = "ValidationError",
+    SubscriptionError = "SubscriptionError",
+    Unknown = "Unknown"
+}
+export interface PortalArtifactsStatusResponse {
+    status: PortalArtifactsGenerationStatus;
+    errors?: Record<string, string[]>;
+}
+export interface PortalArtifactsInitiatedResponse {
+    id: string;
+}

package/lib/types/portal/generation-status.js

@@ -0,0 +1,26 @@
+/**
+ * The statuses `/portal-artifacts` reports. Modelled in full, for the reason the plugin's own
+ * vocabulary is: a status this CLI does not name is indistinguishable from one it does, and the
+ * polling loop decides whether to wait, stop or fail on exactly this value.
+ *
+ * Two differences from `PluginGenerationStatus`, both worth knowing when reading the poll:
+ *
+ * - `SubscriptionError` is reported here. A run refused for the endpoint itself is a 403 on the
+ *   initiate call, but a run refused for *what it asked for* — a language or a context plugin the
+ *   subscription does not carry — is decided inside the orchestrator and comes back as a status.
+ * - `Completed` is never sent on the wire. Like the plugin's status endpoint, this one redirects
+ *   to the download when a run finishes, so the 302 is what the poll reads as success. The value
+ *   is named here because the poll needs one to report.
+ */
+export var PortalArtifactsGenerationStatus;
+(function (PortalArtifactsGenerationStatus) {
+    PortalArtifactsGenerationStatus["Queued"] = "Queued";
+    PortalArtifactsGenerationStatus["ExecutionStarted"] = "ExecutionStarted";
+    PortalArtifactsGenerationStatus["GeneratingArtifacts"] = "GeneratingArtifacts";
+    PortalArtifactsGenerationStatus["Completed"] = "Completed";
+    PortalArtifactsGenerationStatus["Failed"] = "Failed";
+    PortalArtifactsGenerationStatus["ValidationError"] = "ValidationError";
+    PortalArtifactsGenerationStatus["SubscriptionError"] = "SubscriptionError";
+    PortalArtifactsGenerationStatus["Unknown"] = "Unknown";
+})(PortalArtifactsGenerationStatus || (PortalArtifactsGenerationStatus = {}));
+//# sourceMappingURL=generation-status.js.map