@apimatic/cli 1.5.0 → 2.0.0-beta.2

package/lib/infrastructure/generation-status-poller.js

@@ -1,17 +1,19 @@
 import { Status } from '@apimatic/sdk';
 import { err, ok } from 'neverthrow';
+import { REQUEST_TIMEOUT_MS } from '../config/axios-config.js';
+import { replaceHTML } from '../utils/utils.js';
 import { ServiceError } from './service-error.js';
-export const STATUS_POLL_INTERVAL_MS = 3000;
-/**
- * Set well clear of any plausible run: it exists to end a generation that is stuck, not to
- * cap a slow one. No duration data exists for real runs, so this is the number to revisit
- * if a legitimate generation ever reports a timeout.
- */
-export const GENERATION_TIMEOUT_MS = 30 * 60 * 1000;
+import { sleep } from './timer-extensions.js';
+export const TIMING_DEFAULTS = {
+    pollIntervalMs: 3000,
+    // Past `/portal-artifacts`' own 25-minute limit, so the user reads the server's overrun message.
+    generationTimeoutMs: 30 * 60 * 1000,
+    requestTimeoutMs: REQUEST_TIMEOUT_MS
+};
 export async function pollUntilCompleted({ pollIntervalMs, fetchStatus, timeout, formatValidationError = formatValidationErrors }) {
     const deadline = Date.now() + timeout.budgetMs;
     for (;;) {
-        await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
+        await sleep(pollIntervalMs);
         const statusResult = await fetchStatus();
         if (statusResult.isErr()) {
             return err(statusResult.error);
@@ -29,7 +31,7 @@ export async function pollUntilCompleted({ pollIntervalMs, fetchStatus, timeout,
         }
         if (status === Status.SubscriptionError) {
             const message = Object.values(asMessages(errors)).flat()[0];
-            return err(ServiceError.forbidden('Access denied to resource.' + (message ? '\n- ' + message : '')));
+            return err(ServiceError.forbidden('Access denied to resource.' + (message ? '\n' + bulleted([message]) : '')));
         }
         // Every other status keeps the run alive rather than ending it: an endpoint reporting
         // its own in-flight vocabulary is healthy, and the plugin orchestrator reports
@@ -41,16 +43,22 @@ export async function pollUntilCompleted({ pollIntervalMs, fetchStatus, timeout,
         }
     }
 }
+/** Each message under a bullet of its own, any further line of it indented beneath. */
+export const bulleted = (messages) => messages.map((message) => `- ${message.replaceAll('\n', '\n  ')}`).join('\n');
 export const formatValidationErrors = (errors) => {
     const messages = Object.values(errors).flat();
-    return 'One or more validation errors occurred.' + (messages.length ? '\n- ' + messages.join('\n- ') : '');
+    return 'One or more validation errors occurred.' + (messages.length ? '\n' + bulleted(messages) : '');
 };
 const timedOutMessage = (label, budgetMs) => {
-    const minutes = Math.floor(budgetMs / 60000);
+    const minutes = Math.floor(budgetMs / 60_000);
     if (minutes < 1) {
         return `${label} timed out.`;
     }
     return `${label} timed out after ${minutes} ${minutes === 1 ? 'minute' : 'minutes'}.`;
 };
-const asMessages = (errors) => (errors !== null && errors !== void 0 ? errors : {});
+// The server writes its messages as HTML; the terminal gets their text.
+const asMessages = (errors) => Object.fromEntries(Object.entries(errors ?? {}).map(([key, messages]) => [
+    key,
+    (Array.isArray(messages) ? messages : [messages]).map((message) => replaceHTML(String(message)))
+]));
 //# sourceMappingURL=generation-status-poller.js.map

package/lib/infrastructure/generation-status-poller.js.map

@@ -1 +1 @@
-{"version":3,"file":"generation-status-poller.js","sourceRoot":"","sources":["../../src/infrastructure/generation-status-poller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,GAAG,EAAE,EAAE,EAAU,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAE5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAsBpD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAA6B,EACnE,cAAc,EACd,WAAW,EACX,OAAO,EACP,qBAAqB,GAAG,sBAAsB,EAC5B;IAClB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;IAE/C,SAAS,CAAC;QACR,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;QAEpE,MAAM,YAAY,GAAG,MAAM,WAAW,EAAE,CAAC;QACzC,IAAI,YAAY,CAAC,KAAK,EAAE,EAAE,CAAC;YACzB,OAAO,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;QAED,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC;QAE9C,IAAI,MAAM,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;YAChC,OAAO,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC;YAC7B,OAAO,GAAG,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,MAAM,KAAK,MAAM,CAAC,eAAe,EAAE,CAAC;YACtC,MAAM,gBAAgB,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;YAC5C,OAAO,GAAG,CAAC,YAAY,CAAC,UAAU,CAAC,qBAAqB,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC;QACjG,CAAC;QACD,IAAI,MAAM,KAAK,MAAM,CAAC,iBAAiB,EAAE,CAAC;YACxC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC5D,OAAO,GAAG,CAAC,YAAY,CAAC,SAAS,CAAC,4BAA4B,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvG,CAAC;QAED,sFAAsF;QACtF,+EAA+E;QAC/E,oFAAoF;QACpF,oFAAoF;QACpF,qBAAqB;QACrB,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC3B,OAAO,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAA6B,CAAC,MAAM,EAAE,EAAE;IACzE,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,OAAO,yCAAyC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC7G,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,KAAa,EAAE,QAAgB,EAAU,EAAE;IAClE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,KAAM,CAAC,CAAC;IAC9C,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,OAAO,GAAG,KAAK,aAAa,CAAC;IAC/B,CAAC;IACD,OAAO,GAAG,KAAK,oBAAoB,OAAO,IAAI,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC;AACxF,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,MAA2C,EAA4B,EAAE,CAC3F,CAAC,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE,CAA6B,CAAC"}
+{"version":3,"file":"generation-status-poller.js","sourceRoot":"","sources":["../../src/infrastructure/generation-status-poller.ts"],"names":[],"mappings":"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"}

package/lib/infrastructure/launcher-service.js

@@ -12,7 +12,7 @@ export class LauncherService {
             await execa("code", args);
             return true;
         }
-        catch (_a) {
+        catch {
             return false;
         }
     }
@@ -22,7 +22,7 @@ export class LauncherService {
             await execa(command, ["code"]);
             return true;
         }
-        catch (_a) {
+        catch {
             return false;
         }
     }
@@ -32,7 +32,7 @@ export class LauncherService {
             await execa("code", ["--new-window", "--wait", ...args]);
             return true;
         }
-        catch (_a) {
+        catch {
             return false;
         }
     }
@@ -42,7 +42,7 @@ export class LauncherService {
         try {
             await execa("code", ["--wait", filePath.toString()]);
         }
-        catch (_a) {
+        catch {
             // TODO: check for fallback (start)
             if (process.platform === "win32") {
                 await execa("cmd", ["/c", "start", "/wait", "notepad", filePath.toString()], { stdio: "ignore" });
@@ -87,7 +87,7 @@ export class LauncherService {
             const child = spawn(command, args, { stdio: "ignore", detached: true });
             child.unref(); // Let it run without blocking
         }
-        catch (_a) {
+        catch {
             // Silently ignore errors
         }
     }
@@ -97,7 +97,7 @@ export class LauncherService {
         try {
             return open(url.toString());
         }
-        catch (_a) {
+        catch {
             // Silently ignore errors
         }
     }

package/lib/infrastructure/launcher-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"launcher-service.js","sourceRoot":"","sources":["../../src/infrastructure/launcher-service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"launcher-service.js","sourceRoot":"","sources":["../../src/infrastructure/launcher-service.ts"],"names":[],"mappings":"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"}

package/lib/infrastructure/network-service.d.ts

@@ -1,3 +1,6 @@
+import { UrlPath } from '../types/file/urlPath.js';
 export declare class NetworkService {
     getServerPort(preferredPorts: number[]): Promise<number>;
+    /** True once any response, whatever its status, has arrived in full; false if it fails, is cut off or times out. */
+    answers(url: UrlPath, timeoutMs: number): Promise<boolean>;
 }

package/lib/infrastructure/network-service.js

@@ -1,7 +1,21 @@
-import getPort from "get-port";
+import http from 'node:http';
+import { finished } from 'node:stream/promises';
+import getPort from 'get-port';
 export class NetworkService {
     async getServerPort(preferredPorts) {
         return await getPort({ port: preferredPorts });
     }
+    /** True once any response, whatever its status, has arrived in full; false if it fails, is cut off or times out. */
+    answers(url, timeoutMs) {
+        return new Promise((resolve) => {
+            // An agent of its own: under NODE_USE_ENV_PROXY the global one sends even a loopback request to the proxy.
+            http
+                .get(url.toString(), { agent: false, signal: AbortSignal.timeout(timeoutMs) }, (response) => resolve(finished(response.resume())
+                .then(() => true)
+                .catch(() => false)))
+                .on('error', () => resolve(false));
+            // `http.get` throws, rather than failing the request, on a URL it cannot make, such as an https one.
+        }).catch(() => false);
+    }
 }
 //# sourceMappingURL=network-service.js.map

package/lib/infrastructure/network-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"network-service.js","sourceRoot":"","sources":["../../src/infrastructure/network-service.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,UAAU,CAAC;AAE/B,MAAM,OAAO,cAAc;IAClB,KAAK,CAAC,aAAa,CAAC,cAAwB;QACjD,OAAO,MAAM,OAAO,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;IACjD,CAAC;CACF"}
+{"version":3,"file":"network-service.js","sourceRoot":"","sources":["../../src/infrastructure/network-service.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,OAAO,MAAM,UAAU,CAAC;AAG/B,MAAM,OAAO,cAAc;IAClB,KAAK,CAAC,aAAa,CAAC,cAAwB;QACjD,OAAO,MAAM,OAAO,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,oHAAoH;IAC7G,OAAO,CAAC,GAAY,EAAE,SAAiB;QAC5C,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;YACtC,2GAA2G;YAC3G,IAAI;iBACD,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,EAAE,CAC1F,OAAO,CACL,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;iBACxB,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;iBAChB,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CACtB,CACF;iBACA,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;YACrC,qGAAqG;QACvG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;CACF"}

package/lib/infrastructure/portal-build-service.d.ts

@@ -0,0 +1,19 @@
+import { Result } from 'neverthrow';
+import { DirectoryPath } from '../types/file/directoryPath.js';
+import { PortalProjectPaths } from './portal-project-service.js';
+export interface PortalBuildFailure {
+    message: string;
+    /** Combined output of the build, written next to the portal so it can be reported. */
+    log: string;
+}
+export interface PortalBuildResult {
+    /** Directory holding the finished static site. */
+    output: DirectoryPath;
+    pageCount: number;
+}
+export declare class PortalBuildService {
+    private readonly fileService;
+    private readonly projectService;
+    build(project: PortalProjectPaths): Promise<Result<PortalBuildResult, PortalBuildFailure>>;
+    private countPages;
+}

package/lib/infrastructure/portal-build-service.js

@@ -0,0 +1,58 @@
+import { execa } from 'execa';
+import { err, ok } from 'neverthrow';
+import { FileName } from '../types/file/fileName.js';
+import { FilePath } from '../types/file/filePath.js';
+import { SHELL_FILE_NAME } from '../types/portal-context.js';
+import { FileService } from './file-service.js';
+import { CONTENT_COPY_DIRECTORY_NAME, PortalProjectService } from './portal-project-service.js';
+export class PortalBuildService {
+    fileService = new FileService();
+    projectService = new PortalProjectService();
+    async build(project) {
+        const distDirectory = project.projectDirectory.join('dist');
+        await this.fileService.deleteDirectory(distDirectory);
+        // Run in a child process so a build crash or out-of-memory cannot take the CLI with it.
+        const result = await execa(process.execPath, [project.viteBinary.toString(), 'build'], {
+            cwd: project.projectDirectory.toString(),
+            env: this.projectService.childEnvironment(),
+            extendEnv: false,
+            all: true,
+            reject: false
+        });
+        const log = namingSource(result.all ?? '', project);
+        if (result.exitCode !== 0) {
+            return err({ message: 'The portal build failed.', log });
+        }
+        const output = distDirectory.join('client');
+        if (!(await this.fileService.fileExists(new FilePath(output, new FileName('index.html'))))) {
+            return err({ message: 'The portal build produced no home page.', log });
+        }
+        const pageCount = await this.countPages(output);
+        if (pageCount === null) {
+            return err({ message: 'The portal build output could not be read.', log });
+        }
+        if (pageCount === 0) {
+            return err({ message: 'The portal build produced no pages.', log });
+        }
+        return ok({ output, pageCount });
+    }
+    async countPages(output) {
+        try {
+            const directory = await this.fileService.getDirectory(output);
+            const isPage = (file) => file.name().hasExtension('.html') && !file.name().is(SHELL_FILE_NAME);
+            return directory.getAllFiles().filter(isPage).length;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+// The build reads a copy of the pages, in a temporary directory; a reader knows each page by its place in the source.
+function namingSource(log, { projectDirectory, contentSource }) {
+    if (contentSource === null) {
+        return log;
+    }
+    const copy = projectDirectory.join(CONTENT_COPY_DIRECTORY_NAME);
+    return log.replaceAll(copy.toString(), contentSource.toString()).replaceAll(copy.toPosix(), contentSource.toPosix());
+}
+//# sourceMappingURL=portal-build-service.js.map

package/lib/infrastructure/portal-build-service.js.map

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

package/lib/infrastructure/portal-dev-server-service.d.ts

@@ -0,0 +1,29 @@
+import { Result } from 'neverthrow';
+import { UrlPath } from '../types/file/urlPath.js';
+import { PortalProjectPaths } from './portal-project-service.js';
+export interface PortalDevServer {
+    url: UrlPath;
+    /**
+     * Resolves with what the server printed after startup if it stops on its own, so the CLI
+     * stops advertising an address nothing is listening on.
+     */
+    exited: Promise<string>;
+    /** Resolves once the server process has exited. */
+    stop: () => Promise<void>;
+}
+export interface PortalDevServerFailure {
+    message: string;
+    log: string;
+}
+export declare class PortalDevServerService {
+    private readonly projectService;
+    private readonly networkService;
+    start(project: PortalProjectPaths, port: number): Promise<Result<PortalDevServer, PortalDevServerFailure>>;
+    /**
+     * Keeps reading the server's output after startup: detaching lets the pipe fill and block
+     * the server once it has printed enough. Only the tail is kept, so a long session is bounded.
+     */
+    private watchForExit;
+    private waitForUrl;
+    private terminate;
+}

package/lib/infrastructure/portal-dev-server-service.js

@@ -0,0 +1,135 @@
+import { stripVTControlCharacters } from 'node:util';
+import { sleep } from './timer-extensions.js';
+import { execa } from 'execa';
+import { err, ok } from 'neverthrow';
+import { UrlPath } from '../types/file/urlPath.js';
+import { NetworkService } from './network-service.js';
+import { PortalProjectService } from './portal-project-service.js';
+/** A cold start compiles the portal from scratch: its address, and then its first page, each get this long. */
+const STARTUP_TIMEOUT_MS = 3 * 60 * 1000;
+/**
+ * How much of a running server's output is kept, in case it explains a crash. Counted in
+ * characters, not chunks: chunk size varies by platform and Node version, so the same output
+ * bounded at 64 chunks came to 4 KB on one runner and 280 KB on another.
+ */
+const OUTPUT_TAIL_BYTES = 64 * 1024;
+/** How long the last of a dead server's output is waited for before reporting what arrived. */
+const DRAIN_TIMEOUT_MS = 2000;
+// Read after Vite's colour codes are stripped but not the line end, which proves the URL arrived whole.
+const LOCAL_URL_PATTERN = /Local:\s*(https?:\/\/\S+?)\/?[ \t]*[\r\n]/i;
+export class PortalDevServerService {
+    projectService = new PortalProjectService();
+    networkService = new NetworkService();
+    async start(project, port) {
+        // `--strictPort` makes Vite fail instead of silently moving to another port, so the
+        // URL reported to the user is always the one that was reserved.
+        const subprocess = execa(process.execPath, 
+        // Bound explicitly to the IPv4 loopback. Left to itself the server listens on `::1`
+        // only while printing `localhost`, so wherever that name resolves to 127.0.0.1 the
+        // address the CLI reports refuses the connection although the preview is healthy.
+        [project.viteBinary.toString(), 'dev', '--port', String(port), '--strictPort', '--host', '127.0.0.1'], {
+            cwd: project.projectDirectory.toString(),
+            env: this.projectService.childEnvironment(),
+            extendEnv: false,
+            all: true,
+            buffer: false,
+            reject: false,
+            // Vite's dev server ignores SIGTERM while it is optimizing dependencies.
+            forceKillAfterDelay: 5000
+        });
+        const started = await this.waitForUrl(subprocess);
+        if (started.isErr()) {
+            await this.terminate(subprocess);
+            return err(started.error);
+        }
+        // Read from here, the log of a failed first page holds what explains it rather than the address banner.
+        const exited = this.watchForExit(subprocess);
+        // Vite compiles the portal on its first request, not at startup, so it is ready only once one is answered.
+        if (!(await this.networkService.answers(started.value, STARTUP_TIMEOUT_MS))) {
+            await this.terminate(subprocess);
+            return err({ message: 'The portal preview did not answer its first page.', log: await exited });
+        }
+        return ok({
+            url: started.value,
+            exited,
+            stop: () => this.terminate(subprocess)
+        });
+    }
+    /**
+     * Keeps reading the server's output after startup: detaching lets the pipe fill and block
+     * the server once it has printed enough. Only the tail is kept, so a long session is bounded.
+     */
+    watchForExit(subprocess) {
+        const tail = [];
+        let kept = 0;
+        const output = subprocess.all;
+        output?.on('data', (chunk) => {
+            const text = stripVTControlCharacters(chunk.toString());
+            tail.push(text);
+            kept += text.length;
+            // The last chunk always survives, however big: it most likely holds the exit message.
+            while (tail.length > 1 && kept > OUTPUT_TAIL_BYTES) {
+                kept -= tail.shift().length;
+            }
+        });
+        // The process resolves before the last of its output is delivered, so waiting only on
+        // that loses the lines explaining the exit. Bounded, in case the stream never ends.
+        const drained = new Promise((resolve) => {
+            if (!output) {
+                resolve();
+                return;
+            }
+            output.once('end', resolve);
+            output.once('close', resolve);
+            output.once('error', resolve);
+        });
+        const collect = async () => {
+            // Cancelled once the output has arrived: `Promise.race` leaves the loser running, and
+            // a pending timer holds the event loop open. Nothing here calls process.exit(), so the
+            // timer alone kept `portal serve` alive for two seconds after Ctrl+C.
+            const expiry = new AbortController();
+            try {
+                await Promise.race([drained, sleep(DRAIN_TIMEOUT_MS, expiry.signal)]);
+            }
+            finally {
+                expiry.abort();
+            }
+            return tail.join('');
+        };
+        return subprocess.then(collect, collect);
+    }
+    waitForUrl(subprocess) {
+        return new Promise((resolve) => {
+            let log = '';
+            let settled = false;
+            const onData = (chunk) => {
+                log += stripVTControlCharacters(chunk.toString());
+                const match = LOCAL_URL_PATTERN.exec(log);
+                if (match) {
+                    settle(ok(new UrlPath(match[1])));
+                }
+            };
+            const settle = (result) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timer);
+                // The server then runs until the user stops it; left attached, this would buffer
+                // every line it prints for the whole session.
+                subprocess.all?.off('data', onData);
+                resolve(result);
+            };
+            const timer = setTimeout(() => {
+                settle(err({ message: 'The portal preview did not start in time.', log }));
+            }, STARTUP_TIMEOUT_MS);
+            subprocess.all?.on('data', onData);
+            // A failed port bind or a broken config exits before ever printing a URL.
+            void subprocess.then(() => settle(err({ message: 'The portal preview stopped unexpectedly.', log })), () => settle(err({ message: 'The portal preview could not be started.', log })));
+        });
+    }
+    async terminate(subprocess) {
+        subprocess.kill('SIGTERM');
+        await subprocess.catch(() => undefined);
+    }
+}
+//# sourceMappingURL=portal-dev-server-service.js.map

package/lib/infrastructure/portal-dev-server-service.js.map

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

package/lib/infrastructure/portal-pages-service.d.ts

@@ -0,0 +1,17 @@
+import { Result } from 'neverthrow';
+import { DirectoryPath } from '../types/file/directoryPath.js';
+import { GeneratedPages } from '../types/portal/generated-pages.js';
+/**
+ * Writes the pages the CLI generates into a directory of the build project, rendered from the
+ * templates the package ships. A file is written only when its contents change, and whatever
+ * the pages no longer call for is deleted, so under `portal serve` an edit reloads only what it
+ * changed; the answer says whether anything was written or deleted.
+ */
+export declare class PortalPagesService {
+    private readonly fileService;
+    write(directory: DirectoryPath, pages: GeneratedPages): Promise<Result<boolean, string>>;
+    private render;
+    private template;
+    /** Deletes every file and folder in the directory that the pages no longer call for. */
+    private removeStale;
+}

package/lib/infrastructure/portal-pages-service.js

@@ -0,0 +1,103 @@
+import { err, ok } from 'neverthrow';
+import { FileName } from '../types/file/fileName.js';
+import { FilePath } from '../types/file/filePath.js';
+import { NAVIGATION_FILE_NAME } from '../types/portal/portal-navigation.js';
+import { PageTemplate } from '../types/portal/page-template.js';
+import { errorMessage } from '../utils/error-utils.js';
+import { envInfo } from './env-info.js';
+import { FileService } from './file-service.js';
+/** Shipped beside `portal-template/`, one `.mdx` file per template. */
+const TEMPLATES_DIRECTORY_NAME = 'portal-pages';
+/**
+ * Writes the pages the CLI generates into a directory of the build project, rendered from the
+ * templates the package ships. A file is written only when its contents change, and whatever
+ * the pages no longer call for is deleted, so under `portal serve` an edit reloads only what it
+ * changed; the answer says whether anything was written or deleted.
+ */
+export class PortalPagesService {
+    fileService = new FileService();
+    async write(directory, pages) {
+        const files = await this.render(directory, pages);
+        if (files.isErr()) {
+            return err(files.error);
+        }
+        try {
+            let changed = false;
+            for (const { file, contents } of files.value) {
+                if (await this.fileService.replaceContentsIfChanged(file, contents)) {
+                    changed = true;
+                }
+            }
+            const removed = await this.removeStale(directory, files.value);
+            return ok(changed || removed);
+        }
+        catch (error) {
+            return err(errorMessage(error));
+        }
+    }
+    async render(directory, pages) {
+        const templates = new Map();
+        const files = [];
+        for (const page of pages.pages()) {
+            let template = templates.get(page.template);
+            if (template === undefined) {
+                const read = await this.template(page.template);
+                if (read.isErr()) {
+                    return err(read.error);
+                }
+                template = read.value;
+                templates.set(page.template, template);
+            }
+            const rendered = template.render(page.data);
+            if (rendered.isErr()) {
+                return err(`A portal page template could not be filled. ${rendered.error}`);
+            }
+            const folder = directory.join(page.section.folder);
+            files.push({ folder, file: new FilePath(folder, page.fileName), contents: rendered.value });
+        }
+        for (const navigation of pages.navigationFiles()) {
+            const folder = directory.join(navigation.section.folder);
+            files.push({
+                folder,
+                file: new FilePath(folder, new FileName(NAVIGATION_FILE_NAME)),
+                contents: navigation.contents
+            });
+        }
+        return ok(files);
+    }
+    async template(name) {
+        const fileName = new FileName(`${name}.mdx`);
+        const file = new FilePath(envInfo.packageRoot().join(TEMPLATES_DIRECTORY_NAME), fileName);
+        try {
+            return ok(new PageTemplate(fileName, await this.fileService.getContents(file)));
+        }
+        catch {
+            return err(`The portal page template '${fileName}' is missing from this installation. Reinstall the CLI and try again.`);
+        }
+    }
+    /** Deletes every file and folder in the directory that the pages no longer call for. */
+    async removeStale(directory, wanted) {
+        let removed = false;
+        for (const fileName of await this.fileService.getFileNames(directory)) {
+            await this.fileService.deleteFile(new FilePath(directory, fileName));
+            removed = true;
+        }
+        for (const folder of await this.fileService.getSubDirectoriesPaths(directory)) {
+            const inFolder = wanted.filter((candidate) => candidate.folder.isEqual(folder));
+            if (inFolder.length === 0) {
+                await this.fileService.deleteDirectory(folder);
+                removed = true;
+                continue;
+            }
+            for (const fileName of await this.fileService.getFileNames(folder)) {
+                const file = new FilePath(folder, fileName);
+                if (!inFolder.some((candidate) => candidate.file.isEqual(file))) {
+                    await this.fileService.deleteFile(file);
+                    removed = true;
+                }
+            }
+        }
+        return removed;
+    }
+}
+//# sourceMappingURL=portal-pages-service.js.map

package/lib/infrastructure/portal-pages-service.js.map

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