@withbuddi/buddi 0.1.0-pre.53 → 0.1.0-pre.54

package/packages/install/dist/windows-install.js

@@ -0,0 +1,223 @@
+/**
+ * The Windows install (`buddi-<version>-windows-x64-setup.exe`, apps/windows),
+ * as the launcher sees it: the `buddi.cmd` the setup puts on PATH, the task
+ * script for that layout, and which command belongs to which installation.
+ * The counterpart of linux-install.ts. Pure functions with the disk injected,
+ * so the tests run on any machine.
+ *
+ * The layout is the Linux install's, under the data directory:
+ *
+ *     <data>\node\                      node.exe, npm.cmd and npm, VERSION, and
+ *     <data>\node\vcruntime\            the Visual C++ runtime Postgres needs (copied beside it)
+ *     <data>\releases\buddi-<v>\        npm's prefix for a release
+ *     <data>\releases\current, previous junctions into them
+ *
+ * and the setup's own files (the command, the icon, its uninstaller) in
+ * `%LOCALAPPDATA%\Programs\buddi`.
+ *
+ * Node builtins only, and nothing of buddi's but leaf modules: the launcher
+ * and uninstall.ts import it before the environment is set (environment.ts).
+ */
+import { copyFileSync, mkdtempSync } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { APP_LAYOUT_VAR, WINDOWS_INSTALL_VAR, currentLauncher } from './app-layout.js';
+import { cmdLiteral } from './windows-task.js';
+const win = path.win32;
+/** The marker line the setup writes into the `buddi.cmd` it puts on PATH. */
+export const WINDOWS_COMMAND_MARKER = 'rem buddi-windows-install';
+/** The bundled node the Windows install runs: `<data>\node\node.exe`, never the machine's. */
+export function windowsBundledNode(data) {
+    return win.join(data, 'node', 'node.exe');
+}
+/** Where the bundle keeps the Visual C++ runtime DLLs, beside node (see prepareBinaries in @buddi/core). */
+export function vcRuntimeDir(nodeDir) {
+    return win.join(nodeDir, 'vcruntime');
+}
+/** What every process of the Windows install runs with, PATH aside. */
+export function windowsInstallEnvironment(data) {
+    return {
+        BUDDI_DATA_DIR: data,
+        [APP_LAYOUT_VAR]: win.join(data, 'releases'),
+        [WINDOWS_INSTALL_VAR]: '1',
+        npm_config_cache: win.join(data, 'cache', 'npm'),
+    };
+}
+/** The Windows install's PATH: the bundled node first (npm's scripts run `node`). */
+export function windowsInstallPath(data, inherited) {
+    return [win.join(data, 'node'), ...(inherited ? [inherited] : [])].join(';');
+}
+/**
+ * The `buddi.cmd` the setup writes. A batch file, not a PowerShell script:
+ * PowerShell finds it through PATHEXT whatever its script policy says, and
+ * cmd runs it as it is. It never changes with an upgrade: it names `current`.
+ *
+ * cmd reads a batch file in the console's code page, so a data folder with
+ * letters outside English is read in UTF-8 (the file's encoding) and the
+ * owner's code page is put back before node runs; an ASCII path needs neither.
+ */
+export function buildWindowsCommand(data) {
+    const ascii = /^[\x20-\x7e]*$/.test(data);
+    const env = windowsInstallEnvironment(data);
+    const lines = [
+        '@echo off',
+        `${WINDOWS_COMMAND_MARKER}: written by the buddi setup. It runs the buddi in BUDDI_DATA_DIR below.`,
+        'setlocal DisableDelayedExpansion',
+        ...(ascii ? [] : ['for /f "tokens=2 delims=:." %%c in (\'chcp\') do set "BUDDI_CODEPAGE=%%c"', 'chcp 65001 >nul']),
+        ...Object.entries(env).map(([key, value]) => `set "${key}=${cmdLiteral(value)}"`),
+        ...(ascii ? [] : ['chcp %BUDDI_CODEPAGE% >nul', 'set "BUDDI_CODEPAGE="']),
+        // `buddi uninstall` removes the folder node.exe runs from, which Windows
+        // refuses while it runs: that one command runs a copy of it from TEMP.
+        'set "BUDDI_NODE=%BUDDI_DATA_DIR%\\node\\node.exe"',
+        'if /i not "%~1"=="uninstall" goto checked',
+        `set "BUDDI_NODE_COPY=%TEMP%\\${UNINSTALL_NODE_PREFIX}%RANDOM%%RANDOM%"`,
+        'if exist "%BUDDI_NODE%" mkdir "%BUDDI_NODE_COPY%" && copy /y "%BUDDI_NODE%" "%BUDDI_NODE_COPY%\\node.exe" >nul && set "BUDDI_NODE=%BUDDI_NODE_COPY%\\node.exe"',
+        ':checked',
+        'if exist "%BUDDI_DATA_DIR%\\node\\node.exe" if exist "%BUDDI_DATA_DIR%\\releases\\current\\packages\\install\\dist\\launcher.js" goto run',
+        'echo buddi: the installation in %BUDDI_DATA_DIR% is incomplete. Run the buddi setup again: https://withbuddi.com 1>&2',
+        'exit /b 127',
+        ':run',
+        'set "PATH=%BUDDI_DATA_DIR%\\node;%PATH%"',
+        // The last line: node's exit status is the command's.
+        '"%BUDDI_NODE%" "%BUDDI_DATA_DIR%\\releases\\current\\packages\\install\\dist\\launcher.js" %*',
+    ];
+    return lines.join('\r\n') + '\r\n';
+}
+/** The data folder a `buddi.cmd` written by the setup runs, or undefined when it is not one. */
+export function windowsCommandData(text) {
+    if (!text.includes(WINDOWS_COMMAND_MARKER))
+        return undefined;
+    const line = text.split(/\r?\n/).find(l => l.startsWith('set "BUDDI_DATA_DIR='));
+    if (line === undefined || !line.endsWith('"'))
+        return undefined;
+    return line.slice('set "BUDDI_DATA_DIR='.length, -1).replace(/%%/g, '%');
+}
+/** Is this command the setup's, for this data folder? Windows paths ignore case. */
+export function windowsCommandOwnedBy(text, data, real = file => file) {
+    if (text === undefined)
+        return false;
+    const named = windowsCommandData(text);
+    if (named === undefined)
+        return false;
+    const norm = (file) => { try {
+        return real(win.resolve(file)).toLowerCase();
+    }
+    catch {
+        return win.resolve(file).toLowerCase();
+    } };
+    return norm(named) === norm(data);
+}
+/**
+ * What the task runs: the bundled node and `current`'s launcher, named
+ * through the junction so an upgrade's switch needs no new task. Throws when
+ * the bundled node is not there.
+ */
+export function windowsTaskSpec(opts) {
+    const nodePath = windowsBundledNode(opts.data);
+    if (!opts.exists(nodePath))
+        throw new Error(`the bundled Node is missing at ${nodePath}; run the buddi setup again`);
+    const env = windowsInstallEnvironment(opts.data);
+    return {
+        nodePath,
+        entry: currentLauncher(env[APP_LAYOUT_VAR]).split('/').join('\\'),
+        environment: { ...env, ...(opts.extra ?? {}) },
+        pathPrefix: win.dirname(nodePath),
+    };
+}
+/** `installer.json`, read leniently: an absolute command and uninstaller, or nothing. */
+export function readWindowsInstallerRecord(text) {
+    if (text === undefined)
+        return {};
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        return {};
+    }
+    const absolute = (value) => typeof value === 'string' && win.isAbsolute(value) ? value : undefined;
+    const command = absolute(parsed.command);
+    const uninstaller = absolute(parsed.uninstaller);
+    return { ...(command === undefined ? {} : { command }), ...(uninstaller === undefined ? {} : { uninstaller }) };
+}
+/** Set by the setup's uninstaller when it runs `buddi uninstall`: it removes its own entry afterwards. */
+export const SETUP_UNINSTALL_VAR = 'BUDDI_SETUP_UNINSTALL';
+/** How the setup's uninstaller is started from `buddi uninstall`: quietly, with no question left to ask. */
+export const SETUP_UNINSTALL_ARGS = ['/VERYSILENT', '/SUPPRESSMSGBOXES', '/NORESTART'];
+/** The folder name a copy of node for `buddi uninstall` gets in TEMP. */
+export const UNINSTALL_NODE_PREFIX = 'buddi-uninstall-';
+/** Is `file` the folder `dir` or inside it? Windows paths ignore case. */
+export function insideFolder(file, dir, platform = process.platform) {
+    const p = platform === 'win32' ? win : path.posix;
+    const norm = (value) => { const resolved = p.resolve(value); return platform === 'win32' ? resolved.toLowerCase() : resolved; };
+    const f = norm(file);
+    const d = norm(dir).replace(/[\\/]+$/, '');
+    return f === d || f.startsWith(d + p.sep);
+}
+/**
+ * A node that does not run from inside the data folder: Windows will not
+ * remove a folder whose program is running, and the Windows install's node
+ * is `<data>\node\node.exe`. A copy goes to a folder of its own in TEMP, which
+ * `cleanupNodeCopyCommand` removes once that node has exited. Elsewhere, and
+ * for a node outside the folder, the node as it is.
+ */
+export function nodeOutsideData(data, execPath = process.execPath, platform = process.platform, tmp = os.tmpdir()) {
+    if (platform !== 'win32' || !insideFolder(execPath, data, platform))
+        return execPath;
+    const dir = mkdtempSync(path.join(tmp, UNINSTALL_NODE_PREFIX));
+    const copy = path.join(dir, 'node.exe');
+    copyFileSync(execPath, copy);
+    return copy;
+}
+/** The variable the cleanup reads its folder from (never put into its command line). */
+export const NODE_COPY_DIR_VAR = 'BUDDI_NODE_COPY_DIR';
+/**
+ * When this node is such a copy: what removes its folder once it has exited
+ * (it cannot remove itself while it runs). A JScript run by wscript.exe, the
+ * detached child: wscript is a windowed program with no window under `//B`,
+ * so nothing ever shows. A console program would not do: started detached it
+ * has no console (PowerShell then exits at once, doing nothing), and anything
+ * it started would get a console of its own, which Windows 11 shows in Windows
+ * Terminal whatever `windowsHide` asked. The script sleeps half a second
+ * between tries for up to a minute, then deletes itself; the folder comes in
+ * an environment variable, never in its text. The caller writes `script`.
+ */
+export function cleanupNodeCopyCommand(execPath, systemRoot, tmp = os.tmpdir()) {
+    const dir = win.dirname(execPath);
+    if (!win.basename(dir).startsWith(UNINSTALL_NODE_PREFIX) || !insideFolder(dir, tmp, 'win32'))
+        return undefined;
+    const file = win.join(tmp, `buddi-cleanup-${win.basename(dir)}.js`);
+    const text = [
+        'var fso = new ActiveXObject("Scripting.FileSystemObject");',
+        `var dir = new ActiveXObject("WScript.Shell").Environment("Process")("${NODE_COPY_DIR_VAR}");`,
+        'for (var i = 0; i < 120 && dir; i++) {',
+        '  WScript.Sleep(500);',
+        '  try { fso.DeleteFolder(dir, true); } catch (e) {}',
+        '  if (!fso.FolderExists(dir)) break;',
+        '}',
+        'try { fso.DeleteFile(WScript.ScriptFullName, true); } catch (e) {}',
+        '',
+    ].join('\r\n');
+    return {
+        command: win.join(systemRoot, 'System32', 'wscript.exe'),
+        args: ['//B', '//NoLogo', '//E:JScript', file],
+        env: { [NODE_COPY_DIR_VAR]: dir },
+        script: { file, text },
+    };
+}
+/** Where the setup records the data folder its uninstaller removes (HKCU), as `reg query` prints it. */
+export const SETUP_DATA_KEY = 'HKCU\\Software\\buddi';
+/** The value `reg query <key> /v DataDir` printed, or undefined. */
+export function regQueryValue(output, name) {
+    for (const line of output.split(/\r?\n/)) {
+        const match = new RegExp(`^\\s*${name}\\s+REG_(?:EXPAND_)?SZ\\s+(.*)$`, 'i').exec(line);
+        if (match)
+            return match[1].trim();
+    }
+    return undefined;
+}
+/** Is the setup's uninstaller this installation's (it removes the data folder the registry names)? */
+export function uninstallerIsOurs(registered, data) {
+    return registered !== undefined && win.resolve(registered).toLowerCase() === win.resolve(data).toLowerCase();
+}
+//# sourceMappingURL=windows-install.js.map

package/packages/install/dist/windows-install.js.map

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

package/packages/install/dist/windows-setup.d.ts

@@ -0,0 +1,107 @@
+#!/usr/bin/env node
+export interface SetupArgs {
+    command: 'install' | 'uninstall';
+    bundle?: string;
+    data?: string;
+    bin?: string;
+    uninstaller?: string;
+    noStart: boolean;
+    skipBackup: boolean;
+    keepData: boolean;
+    log?: string;
+    result?: string;
+    summary?: string;
+}
+/** The command line the setup passes. Anything else is refused. */
+export declare function parseSetupArgs(argv: readonly string[]): SetupArgs;
+export interface SetupFacts {
+    /** `<data>\installation.json` is there. */
+    existing: boolean;
+    /** The release `current` resolves to, and its version. */
+    oldRoot?: string;
+    oldVersion?: string;
+    newVersion: string;
+    /** `current` already is this bundle's release. */
+    sameRelease: boolean;
+    /** An npm copy on PATH, and whether it serves this data folder. */
+    npm?: {
+        version?: string;
+        serves: boolean;
+    };
+    skipBackup: boolean;
+    /** The data an uninstall with "Keep my data" left (environment.ts keptForReinstall). */
+    kept?: boolean;
+}
+export interface SetupPlan {
+    kind: 'fresh' | 'reinstall' | 'upgrade' | 'move';
+    /**
+     * `take`: back up with the buddi there now; `kept`: data a keep-data
+     * uninstall left, whose buddi is gone (its last backup is in its backups
+     * folder, and the install leaves the folder as it is); `refuse`: data that
+     * nothing here can back up.
+     */
+    backup: 'none' | 'take' | 'skipped' | 'kept' | 'refuse';
+    /** Which buddi serves the data now: the release under `current`, npm's copy, or none. */
+    old: 'release' | 'npm' | 'none';
+    /** The version recorded as `from` in the upgrade marker. */
+    from?: string;
+}
+export declare function setupPlan(f: SetupFacts): SetupPlan;
+/** The newest backup archive in any of these folders (the uninstall keeps its last one in the data folder's backups, or in buddi-backups when the dashboard took it). */
+export declare function lastKeptBackup(dirs: string[], list?: (dir: string) => Array<{
+    name: string;
+    mtimeMs: number;
+}>): string | undefined;
+/** The newest archive in `<data>\backups` (not an envelope or a passphrase file). */
+export declare function newestArchive(names: Array<{
+    name: string;
+    mtimeMs: number;
+}>): string | undefined;
+/** Does npm's `buddi.cmd` shim run `@withbuddi/buddi` from beside it? */
+export declare function npmShimRunsBuddi(text: string | undefined): boolean;
+/** The lines of `buddi uninstall`'s output the owner must keep: where the backup is, and its passphrase. */
+export declare function uninstallSummary(output: string): string[];
+export declare class Said {
+    private readonly file;
+    lines: string[];
+    constructor(file: string | undefined);
+    say(line: string): void;
+    /** Into the log only: what helps a report, not the owner (a stack). */
+    record(line: string): void;
+}
+export declare class SetupError extends Error {
+}
+export interface Run {
+    code: number;
+    output: string;
+}
+/**
+ * Everything `install` does to processes, as seams: the real ones below, fakes
+ * in the tests (windows-setup.test.ts), so the backup, the stop, the marker,
+ * the swap, the rollback and the takeover are tested on a folder, anywhere.
+ */
+export interface InstallDeps {
+    /** The supervisor answering for this data folder: its install root, or undefined when none answers. */
+    status(data: string): Promise<{
+        installRoot?: string;
+    } | undefined>;
+    /** Stop that supervisor on its pipe and wait for it and its database. */
+    stop(data: string): Promise<void>;
+    /** Run a release's launcher with the bundled node and the Windows install's environment. */
+    runRelease(data: string, root: string, argv: string[]): Promise<Run>;
+    /** Run npm's `buddi.cmd` for this data folder. */
+    runNpm(cmd: string, data: string, argv: string[]): Promise<Run>;
+    /** The folders on PATH, where npm's `buddi.cmd` is looked for. */
+    pathDirs(): string[];
+    /** The scripts of every other buddi task on this machine (Task Scheduler), their text. */
+    otherTaskScripts(data: string): Promise<string[]>;
+}
+/** Does any of these task scripts run something from inside this package folder? */
+export declare function scriptsUse(scripts: string[], pkg: string): boolean;
+export declare function install(args: SetupArgs, said: Said, deps?: InstallDeps): Promise<number>;
+/** What the setup alone puts in the data folder, before buddi first starts. */
+export declare const NEVER_STARTED_PARTS: string[];
+export declare function main(argv: readonly string[]): Promise<number>;
+/** Is this module the program node was asked to run? Named through `current` (a junction) it is still this file; Windows paths ignore case. */
+export declare function runAsProgram(argv1: string | undefined, self: string, resolve?: (file: string) => string): boolean;
+//# sourceMappingURL=windows-setup.d.ts.map

package/packages/install/dist/windows-setup.d.ts.map

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