@apimatic/cli 1.4.0 → 2.0.0-beta.1

package/lib/infrastructure/file-service.js

@@ -1,18 +1,30 @@
-import fs from "fs";
-import fsExtra from "fs-extra";
-import * as path from "path";
-import { pipeline } from "stream";
-import { promisify } from "util";
-import { DirectoryPath } from "../types/file/directoryPath.js";
-import { Directory } from "../types/file/directory.js";
-import { FileName } from "../types/file/fileName.js";
+import { randomUUID } from 'node:crypto';
+import fs from 'node:fs';
+import fsExtra from 'fs-extra';
+import * as path from 'node:path';
+import { pipeline } from 'node:stream';
+import { promisify } from 'node:util';
+import { FilePath } from '../types/file/filePath.js';
+import { DirectoryPath } from '../types/file/directoryPath.js';
+import { Directory } from '../types/file/directory.js';
+import { FileName } from '../types/file/fileName.js';
+import { sleep } from './timer-extensions.js';
+/** `stat` follows a link, so a link to nothing fails as though the entry were not there. */
+function isDanglingLink(error) {
+    const code = error?.code;
+    return code === 'ENOENT' || code === 'ENOTDIR';
+}
+function spelling(name, entries, nameOf) {
+    return (entries.find((entry) => nameOf(entry) === name) ??
+        entries.find((entry) => nameOf(entry).toLowerCase() === name.toLowerCase()));
+}
 export class FileService {
     async fileExists(file) {
         try {
             const stat = await fsExtra.stat(file.toString());
             return stat.isFile();
         }
-        catch (_a) {
+        catch {
             return false;
         }
     }
@@ -21,7 +33,7 @@ export class FileService {
             const stat = fsExtra.statSync(file.toString());
             return stat.isFile();
         }
-        catch (_a) {
+        catch {
             return false;
         }
     }
@@ -30,7 +42,7 @@ export class FileService {
             const stat = await fsExtra.stat(dir.toString());
             return stat.isDirectory();
         }
-        catch (_a) {
+        catch {
             return false;
         }
     }
@@ -39,17 +51,21 @@ export class FileService {
             const stat = fsExtra.statSync(dir.toString());
             return stat.isDirectory();
         }
-        catch (_a) {
+        catch {
             return false;
         }
     }
+    /**
+     * Hidden entries do not count: scaffolding into a directory that holds only a `.git` is
+     * the normal way to start a project, so the prompts say "apart from hidden files".
+     */
     async directoryEmpty(dir) {
         try {
             const files = await fsExtra.readdir(dir.toString());
-            return files.filter((file) => !file.startsWith(".")).length === 0;
+            return files.filter((file) => !file.startsWith('.')).length === 0;
         }
         catch (error) {
-            return error instanceof Error && "code" in error && error.code === "ENOENT";
+            return error instanceof Error && 'code' in error && error.code === 'ENOENT';
         }
     }
     async cleanDirectory(dir) {
@@ -68,39 +84,93 @@ export class FileService {
     async createDirectoryIfNotExists(dir) {
         await fsExtra.ensureDir(dir.toString());
     }
+    /**
+     * The whole tree beneath `directoryPath`. A link to nothing is left out rather than failing
+     * the walk, which is what a glob over the same tree would do with it. Any other failure
+     * still throws: a file that cannot be examined is a file the caller would otherwise never
+     * hear about, and a missing specification is worse than a failed build.
+     */
     async getDirectory(directoryPath) {
         const entries = await fsExtra.readdir(directoryPath.toString());
         const results = await Promise.all(entries.map(async (entry) => {
             const fullPath = path.join(directoryPath.toString(), entry);
-            const stat = await fsExtra.stat(fullPath);
-            return stat.isDirectory() ? await this.getDirectory(new DirectoryPath(fullPath)) : { fileName: new FileName(entry) };
+            let stat;
+            try {
+                stat = await fsExtra.stat(fullPath);
+            }
+            catch (error) {
+                if (isDanglingLink(error)) {
+                    return undefined;
+                }
+                throw error;
+            }
+            return stat.isDirectory()
+                ? await this.getDirectory(new DirectoryPath(fullPath))
+                : { fileName: new FileName(entry) };
         }));
-        return new Directory(directoryPath, results);
+        return new Directory(directoryPath, results.filter((item) => item !== undefined));
+    }
+    /**
+     * The names of the files directly inside `dir`. `getDirectory` walks the whole tree and
+     * stats every entry, which is wasted work when only the top level is wanted, and throws on
+     * an entry it cannot stat -- out of callers that have no way to report it.
+     */
+    async getFileNames(dir) {
+        return (await this.listEntries(dir)).fileNames;
     }
     async getSubDirectoriesPaths(dir) {
+        return (await this.listEntries(dir)).subDirectories;
+    }
+    // By code point first: Windows and macOS open `logo.png` for `Logo.PNG`, where a web server would not.
+    async spelledOnDisk(root, file) {
+        const names = path.relative(root.toString(), file.toString()).split(path.sep);
+        const fileName = names.pop() ?? '';
+        let directory = root;
+        for (const name of names) {
+            const { subDirectories } = await this.listEntries(directory);
+            const match = spelling(name, subDirectories, (subDirectory) => path.basename(subDirectory.toString()));
+            if (match === undefined) {
+                return null;
+            }
+            directory = match;
+        }
+        const { fileNames } = await this.listEntries(directory);
+        const match = spelling(fileName, fileNames, (candidate) => candidate.toString());
+        return match === undefined ? null : new FilePath(directory, match);
+    }
+    // The direct children of `dir`, split into files and directories; both empty when it cannot
+    // be read. A symlink counts as what it points at: skipping it silently drops an entry the
+    // user did put there.
+    async listEntries(dir) {
+        const fileNames = [];
+        const subDirectories = [];
         try {
-            const entries = await fsExtra.readdir(dir.toString());
-            const directories = [];
-            for (const entry of entries) {
-                const fullPath = dir.join(entry).toString();
-                const stat = await fsExtra.stat(fullPath);
-                if (stat.isDirectory()) {
-                    directories.push(new DirectoryPath(fullPath));
+            for (const entry of await fsExtra.readdir(dir.toString(), { withFileTypes: true })) {
+                const isDirectory = entry.isSymbolicLink()
+                    ? (await fsExtra.stat(dir.join(entry.name).toString()).catch(() => null))?.isDirectory() ?? false
+                    : entry.isDirectory();
+                if (isDirectory) {
+                    subDirectories.push(dir.join(entry.name));
+                }
+                else {
+                    fileNames.push(new FileName(entry.name));
                 }
             }
-            return directories;
         }
-        catch (_a) {
-            return [];
+        catch {
+            // Unreadable: reported as empty, the caller has nothing to do about it.
         }
+        return { fileNames, subDirectories };
     }
     async copyDirectoryContents(source, destination) {
+        await this.forEachEntry(source, destination, (from, to) => fsExtra.copy(from, to));
+    }
+    async moveDirectoryContents(source, destination) {
+        await this.forEachEntry(source, destination, (from, to) => fsExtra.move(from, to, { overwrite: true }));
+    }
+    async forEachEntry(source, destination, operation) {
         const entries = await fsExtra.readdir(source.toString());
-        await Promise.all(entries.map(async (entry) => {
-            const srcEntry = path.join(source.toString(), entry);
-            const destEntry = path.join(destination.toString(), entry);
-            await fsExtra.copy(srcEntry, destEntry);
-        }));
+        await Promise.all(entries.map((entry) => operation(path.join(source.toString(), entry), path.join(destination.toString(), entry))));
     }
     async copyDirectoryExcluding(source, destination, excludeNames) {
         await this.createDirectoryIfNotExists(destination);
@@ -134,29 +204,22 @@ export class FileService {
         const deadline = Date.now() + timeoutMs;
         const deleteFailurePersistsMaxDelay = Date.now() + 5 * 1000;
         let actionPerformed = false;
-        while (Date.now() < deadline && await this.deleteDirectory(dirPath).then(() => false).catch(() => true)) {
+        while (Date.now() < deadline &&
+            (await this.deleteDirectory(dirPath)
+                .then(() => false)
+                .catch(() => true))) {
             if (!actionPerformed && Date.now() > deleteFailurePersistsMaxDelay) {
                 onDeleteFailurePersists();
                 actionPerformed = true;
             }
-            await new Promise((resolve) => setTimeout(resolve, 500));
+            await sleep(500);
         }
     }
-    getRelativePath(filePath, basePath) {
-        const filePathStr = filePath.toString();
-        const basePathStr = basePath.toString();
-        if (filePathStr.startsWith(basePathStr)) {
-            const relativePath = filePathStr.substring(basePathStr.length).replace(/^[/\\]/, "");
-            return relativePath.replace(/\\/g, "/");
-        }
-        // Normalize the full path if it doesn't start with basePath
-        return filePathStr.replace(/\\/g, "/");
-    }
     async getStream(filePath) {
         return fs.createReadStream(filePath.toString());
     }
     async getContents(filePath) {
-        return await fsExtra.readFile(filePath.toString(), "utf-8");
+        return await fsExtra.readFile(filePath.toString(), 'utf-8');
     }
     async writeFile(filePath, stream) {
         const writeStream = fs.createWriteStream(filePath.toString());
@@ -166,17 +229,53 @@ export class FileService {
         await fsExtra.ensureFile(filePath.toString());
     }
     async writeContents(filePath, contents) {
-        await fsExtra.writeFile(filePath.toString(), contents, "utf-8");
+        await fsExtra.writeFile(filePath.toString(), contents, 'utf-8');
+    }
+    /**
+     * Writes beside the target and renames over it, so a fault mid-write leaves the target as it
+     * was rather than half-written. The temporary file goes on a failure for the same reason: a
+     * write that did not happen must leave nothing behind.
+     */
+    async replaceContents(filePath, contents) {
+        const target = filePath.toString();
+        await fsExtra.ensureDir(path.dirname(target));
+        const temporary = `${target}.${randomUUID()}.tmp`;
+        try {
+            await fsExtra.writeFile(temporary, contents, 'utf-8');
+            await fsExtra.rename(temporary, target);
+        }
+        catch (error) {
+            await fsExtra.remove(temporary).catch(() => undefined);
+            throw error;
+        }
+    }
+    /** Renamed over, so a watcher never reads it half-written, and skipped when unchanged, so nothing reloads. */
+    async replaceContentsIfChanged(filePath, contents) {
+        const current = (await this.fileExists(filePath)) ? await this.getContents(filePath) : null;
+        if (current === contents) {
+            return false;
+        }
+        await this.replaceContents(filePath, contents);
+        return true;
     }
     async copy(source, destination) {
         await fsExtra.copyFile(source.toString(), destination.toString());
     }
+    /** Skipped when the destination has the source's size and time, to the millisecond a copy keeps. */
+    async copyIfChanged(source, destination) {
+        const [from, to] = await Promise.all([
+            fsExtra.stat(source.toString()),
+            fsExtra.stat(destination.toString()).catch(() => undefined)
+        ]);
+        if (to !== undefined && to.size === from.size && Math.trunc(to.mtimeMs) === Math.trunc(from.mtimeMs)) {
+            return false;
+        }
+        await fsExtra.copy(source.toString(), destination.toString(), { preserveTimestamps: true });
+        return true;
+    }
     async copyToDir(source, destination) {
         await fsExtra.copyFile(source.toString(), source.replaceDirectory(destination).toString());
     }
-    async readFile(filePath) {
-        return await fsExtra.readFile(filePath.toString(), "utf-8");
-    }
     async isZipFile(filePath) {
         try {
             const buffer = await fsExtra.readFile(filePath.toString());
@@ -186,13 +285,10 @@ export class FileService {
                 buffer[2] === 0x03 && // \x03
                 buffer[3] === 0x04); // \x04
         }
-        catch (_a) {
+        catch {
             return false;
         }
     }
-    async hasContent(file, content) {
-        return (await this.fileExists(file)) && (await this.readFile(file)).includes(content);
-    }
     async getAvailableDirectoryPath(currentPath) {
         if (!(await this.directoryExists(currentPath)))
             return currentPath;

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

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

package/lib/infrastructure/file-watch-service.d.ts

@@ -0,0 +1,40 @@
+import { Result } from 'neverthrow';
+import { DirectoryPath } from '../types/file/directoryPath.js';
+import { FileName } from '../types/file/fileName.js';
+/**
+ * How long the events of one save are gathered before it is reported. An editor saves in
+ * several steps -- truncate and write, or write a copy and rename it over the original -- and
+ * each arrives as its own event, the first while the file may still be empty.
+ */
+export declare const SETTLE_MS = 150;
+export interface FileWatch {
+    /**
+     * Handles the file as though it had just been saved, in turn with any save being handled.
+     * For a caller that read the file some time before the watch began.
+     */
+    recheck(): void;
+    /**
+     * Stops watching, and resolves once a save already being handled is done with, so the
+     * caller can take down what the handler writes to. Nothing is reported after it is called,
+     * not even a save still gathering.
+     */
+    close(): Promise<void>;
+}
+export declare class FileWatchService {
+    private readonly platform;
+    constructor(platform?: NodeJS.Platform);
+    /**
+     * Calls `onChange` once each save of the file has settled, and never twice at once. Saves
+     * that land while one is being handled are handled once more when it finishes, however many
+     * there were, since that one read of the file sees them all. The directory is watched rather
+     * than the file, because an editor that saves by renaming a new file over the old one leaves
+     * a watch on the file itself watching nothing. A watch that fails once running reports
+     * nothing further, and says why through `onFailed`.
+     */
+    watch(directory: DirectoryPath, fileName: FileName, onChange: () => Promise<void>, onFailed: (reason: string) => void): Result<FileWatch, string>;
+    /**
+     * As `watch`, for a save of any file at any depth below `directory`, but for one whose name or
+     * a folder on whose way `isIgnored` answers true for, such as an editor's swap file.
+     */
+    watchTree(directory: DirectoryPath, onChange: () => Promise<void>, onFailed: (reason: string) => void, isIgnored?: (name: string) => boolean): Result<FileWatch, string>;
+}

package/lib/infrastructure/file-watch-service.js

@@ -0,0 +1,167 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { err, ok } from 'neverthrow';
+import { errorMessage } from '../utils/error-utils.js';
+/**
+ * How long the events of one save are gathered before it is reported. An editor saves in
+ * several steps -- truncate and write, or write a copy and rename it over the original -- and
+ * each arrives as its own event, the first while the file may still be empty.
+ */
+export const SETTLE_MS = 150;
+export class FileWatchService {
+    platform;
+    constructor(platform = process.platform) {
+        this.platform = platform;
+    }
+    /**
+     * Calls `onChange` once each save of the file has settled, and never twice at once. Saves
+     * that land while one is being handled are handled once more when it finishes, however many
+     * there were, since that one read of the file sees them all. The directory is watched rather
+     * than the file, because an editor that saves by renaming a new file over the old one leaves
+     * a watch on the file itself watching nothing. A watch that fails once running reports
+     * nothing further, and says why through `onFailed`.
+     */
+    watch(directory, fileName, onChange, onFailed) {
+        return settledWatch(onChange, onFailed, (notify, fail) => {
+            const watcher = fs.watch(realPath(directory), (_event, changed) => {
+                // Some platforms leave the name out of an event; one without it may be this file.
+                if (changed === null || fileName.is(changed.toString())) {
+                    notify();
+                }
+            });
+            watcher.on('error', fail);
+            return () => watcher.close();
+        });
+    }
+    /**
+     * As `watch`, for a save of any file at any depth below `directory`, but for one whose name or
+     * a folder on whose way `isIgnored` answers true for, such as an editor's swap file.
+     */
+    watchTree(directory, onChange, onFailed, isIgnored = () => false) {
+        return settledWatch(onChange, onFailed, (notify, fail) => {
+            const root = realPath(directory);
+            // Elsewhere Node watches each file, and loses one an editor saves by renaming a new one over it.
+            if (this.platform === 'win32' || this.platform === 'darwin') {
+                const watcher = fs.watch(root, { recursive: true }, (_event, changed) => {
+                    if (changed === null || !changed.toString().split(/[\\/]/).some(isIgnored)) {
+                        notify();
+                    }
+                });
+                watcher.on('error', fail);
+                return () => watcher.close();
+            }
+            return watchEachDirectory(root, isIgnored, notify, fail);
+        });
+    }
+}
+// On Windows, libuv aborts the whole process at the first event under a directory named by
+// its 8.3 short name, as a TEMP of C:\Users\RUNNER~1\... is, so the real path is watched.
+function realPath(directory) {
+    return fs.realpathSync.native(directory.toString());
+}
+function settledWatch(onChange, onFailed, start) {
+    let stop = () => undefined;
+    let timer;
+    let closed = false;
+    let waiting = false;
+    let running = Promise.resolve();
+    const report = () => {
+        timer = undefined;
+        if (waiting) {
+            return;
+        }
+        waiting = true;
+        running = running.then(async () => {
+            waiting = false;
+            if (!closed) {
+                await onChange().catch(() => undefined);
+            }
+        });
+    };
+    const notify = () => {
+        if (closed) {
+            return;
+        }
+        clearTimeout(timer);
+        timer = setTimeout(report, SETTLE_MS);
+    };
+    const fail = (error) => {
+        if (closed) {
+            return;
+        }
+        closed = true;
+        clearTimeout(timer);
+        stop();
+        onFailed(errorMessage(error));
+    };
+    try {
+        stop = start(notify, fail);
+    }
+    catch (error) {
+        return err(errorMessage(error));
+    }
+    return ok({
+        recheck: () => {
+            if (!closed) {
+                report();
+            }
+        },
+        close: async () => {
+            closed = true;
+            clearTimeout(timer);
+            stop();
+            await running;
+        }
+    });
+}
+/** One watch per directory, as `watch` keeps on its one, since a directory's watch hears a file renamed over. */
+function watchEachDirectory(root, isIgnored, notify, fail) {
+    const watchers = new Map();
+    const unwatch = (directory) => {
+        watchers.get(directory)?.close();
+        watchers.delete(directory);
+    };
+    const watchDirectory = (directory) => {
+        const watcher = fs.watch(directory, (_event, changed) => {
+            if (changed !== null && isIgnored(changed.toString())) {
+                return;
+            }
+            try {
+                // Windows goes on reporting a watched directory that was taken away until its watch closes.
+                if (!fs.existsSync(directory)) {
+                    unwatch(directory);
+                }
+                else if (changed !== null) {
+                    watchTreeBelow(path.join(directory, changed.toString()));
+                }
+            }
+            catch (error) {
+                fail(error);
+                return;
+            }
+            notify();
+        });
+        watcher.on('error', (error) => (directory === root ? fail(error) : unwatch(directory)));
+        watchers.set(directory, watcher);
+    };
+    const watchTreeBelow = (directory) => {
+        if (watchers.has(directory) || !fs.lstatSync(directory, { throwIfNoEntry: false })?.isDirectory()) {
+            return;
+        }
+        watchDirectory(directory);
+        for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+            if (entry.isDirectory() && !isIgnored(entry.name)) {
+                watchTreeBelow(path.join(directory, entry.name));
+            }
+        }
+    };
+    try {
+        watchTreeBelow(root);
+    }
+    catch (error) {
+        [...watchers.keys()].forEach(unwatch);
+        throw error;
+    }
+    return () => [...watchers.keys()].forEach(unwatch);
+}
+//# sourceMappingURL=file-watch-service.js.map

package/lib/infrastructure/file-watch-service.js.map

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

package/lib/infrastructure/generation-status-poller.d.ts

@@ -1,12 +1,11 @@
 import { Result } from 'neverthrow';
 import { ServiceError } from './service-error.js';
-export declare 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 declare const GENERATION_TIMEOUT_MS: number;
+export declare const TIMING_DEFAULTS: {
+    pollIntervalMs: number;
+    generationTimeoutMs: number;
+    requestTimeoutMs: number;
+};
+export type GenerationTimings = Partial<typeof TIMING_DEFAULTS>;
 export interface GenerationStatus {
     status: string;
     errors?: Record<string, unknown>;
@@ -28,4 +27,6 @@ export interface GenerationPoll<T extends GenerationStatus> {
     formatValidationError?: ValidationErrorFormatter;
 }
 export declare function pollUntilCompleted<T extends GenerationStatus>({ pollIntervalMs, fetchStatus, timeout, formatValidationError }: GenerationPoll<T>): Promise<Result<T, ServiceError>>;
+/** Each message under a bullet of its own, any further line of it indented beneath. */
+export declare const bulleted: (messages: string[]) => string;
 export declare const formatValidationErrors: ValidationErrorFormatter;