@gitkraken/core-gitlens 0.1.0

package/dist/utils/env/node/exec.js

@@ -0,0 +1,277 @@
+import { exec, execFile, spawn } from 'child_process';
+import { access, constants } from 'fs';
+import { stat } from 'fs/promises';
+import { join as joinPaths } from 'path';
+import * as process from 'process';
+import { getScopedLogger, maybeStartScopedLogger } from '../../logger.scoped.js';
+import { normalizePath } from '../../path.js';
+import { isWindows } from './platform.js';
+export class RunError extends Error {
+    cmd;
+    killed;
+    code;
+    signal;
+    stdout;
+    stderr;
+    constructor(context, stdout, stderr) {
+        super(context.message);
+        this.cmd = context.cmd;
+        this.killed = context.killed;
+        this.code = context.code ?? undefined;
+        this.signal = context.signal;
+        this.stdout = stdout?.trim() ?? '';
+        this.stderr = stderr?.trim() ?? '';
+        this.name = 'RunError';
+        Error.captureStackTrace?.(this, new.target);
+    }
+}
+export class CancelledRunError extends RunError {
+    constructor(cmd, killed, code, signal = 'SIGTERM') {
+        super({ message: `Operation cancelled; command=${cmd}`, cmd: cmd, killed: killed, code: code, signal: signal }, '', '');
+        this.name = 'CancelledRunError';
+        Error.captureStackTrace?.(this, new.target);
+    }
+}
+// -- Execution utilities --
+const slashesRegex = /[\\/]/;
+const ps1Regex = /\.ps1$/i;
+const batOrCmdRegex = /\.(bat|cmd)$/i;
+const jsRegex = /\.(js)$/i;
+/**
+ * Search PATH to see if a file exists in any of the path folders.
+ *
+ * @param  {string} exe The file to search for
+ * @return {string}     A fully qualified path, or the original path if nothing
+ *                      is found
+ *
+ * @private
+ */
+async function runDownPath(exe) {
+    // NB: Windows won't search PATH looking for executables in spawn like
+    // Posix does
+    // Files with any directory path don't get this applied
+    if (slashesRegex.test(exe))
+        return exe;
+    const target = joinPaths('.', exe);
+    try {
+        const stats = await stat(target);
+        if (stats?.isFile() && isExecutable(stats))
+            return target;
+    }
+    catch { }
+    const path = process.env.PATH;
+    if (path != null && path.length !== 0) {
+        const haystack = path.split(isWindows ? ';' : ':');
+        for (const p of haystack) {
+            const needle = joinPaths(p, exe);
+            try {
+                const stats = await stat(needle);
+                if (stats?.isFile() && isExecutable(stats))
+                    return needle;
+            }
+            catch { }
+        }
+    }
+    return exe;
+}
+function isExecutable(stats) {
+    if (isWindows)
+        return true;
+    const isGroup = stats.gid ? stats.gid === process.getgid?.() : true;
+    const isUser = stats.uid ? stats.uid === process.getuid?.() : true;
+    return Boolean(stats.mode & 0o0001 || (stats.mode & 0o0010 && isGroup) || (stats.mode & 0o0100 && isUser));
+}
+/**
+ * Finds the executable and parameters to run on Windows. This method
+ * mimics the POSIX behavior of being able to run scripts as executables by
+ * replacing the passed-in executable with the script runner, for PowerShell,
+ * CMD, and node scripts.
+ *
+ * This method also does the work of running down PATH, which spawn on Windows
+ * also doesn't do, unlike on POSIX.
+ */
+export async function findExecutable(exe, args) {
+    // POSIX can just execute scripts directly, no need for silly goosery
+    if (!isWindows)
+        return { cmd: await runDownPath(exe), args: args };
+    if (!(await fsExists(exe))) {
+        // NB: When you write something like `surf-client ... -- surf-build` on Windows,
+        // a shell would normally convert that to surf-build.cmd, but since it's passed
+        // in as an argument, it doesn't happen
+        const possibleExts = ['.exe', '.bat', '.cmd', '.ps1'];
+        for (const ext of possibleExts) {
+            const possibleFullPath = await runDownPath(`${exe}${ext}`);
+            if (await fsExists(possibleFullPath))
+                return findExecutable(possibleFullPath, args);
+        }
+    }
+    if (ps1Regex.test(exe)) {
+        const cmd = joinPaths(process.env.SYSTEMROOT ?? 'C:\\WINDOWS', 'System32', 'WindowsPowerShell', 'v1.0', 'PowerShell.exe');
+        const psargs = ['-ExecutionPolicy', 'Unrestricted', '-NoLogo', '-NonInteractive', '-File', exe];
+        return { cmd: cmd, args: [...psargs, ...args] };
+    }
+    if (batOrCmdRegex.test(exe)) {
+        const cmd = joinPaths(process.env.SYSTEMROOT ?? 'C:\\WINDOWS', 'System32', 'cmd.exe');
+        const cmdArgs = ['/C', exe, ...args];
+        return { cmd: cmd, args: cmdArgs };
+    }
+    if (jsRegex.test(exe)) {
+        const cmd = process.execPath;
+        const nodeArgs = [exe];
+        return { cmd: cmd, args: [...nodeArgs, ...args] };
+    }
+    return { cmd: exe, args: args };
+}
+export async function getWindowsShortPath(path) {
+    return new Promise((resolve, reject) => {
+        exec(`for %I in ("${path}") do @echo %~sI`, (error, stdout, _stderr) => {
+            if (error != null) {
+                reject(error);
+                return;
+            }
+            resolve(normalizePath(stdout.trim()));
+        });
+    });
+}
+const bufferExceededRegex = /stdout maxBuffer( length)? exceeded/;
+export function run(command, args, encoding, options) {
+    const scope = getScopedLogger() ?? maybeStartScopedLogger('Exec.run');
+    const { stdin, stdinEncoding, cancellation, decode, ...opts } = {
+        maxBuffer: 1000 * 1024 * 1024,
+        ...options,
+    };
+    const promise = new Promise((resolve, reject) => {
+        const proc = execFile(command, args, { ...opts, signal: cancellation }, async (error, stdout, stderr) => {
+            if (options?.exitCodeOnly) {
+                resolve((error?.code ?? proc.exitCode));
+                return;
+            }
+            if (error != null) {
+                if (error.signal === 'SIGTERM') {
+                    reject(new CancelledRunError(`${command} ${args.join(' ')}`, true, error.code ?? undefined, error.signal));
+                    return;
+                }
+                if (bufferExceededRegex.test(error.message)) {
+                    error.message = `Command output exceeded the allocated stdout buffer. Set 'options.maxBuffer' to a larger value than ${opts.maxBuffer} bytes`;
+                }
+                let stdoutDecoded;
+                let stderrDecoded;
+                if (encoding === 'utf8' || encoding === 'binary' || encoding === 'buffer') {
+                    // stdout & stderr can be `Buffer` or `string
+                    // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-conversion
+                    stdoutDecoded = stdout.toString();
+                    // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-conversion
+                    stderrDecoded = stderr.toString();
+                }
+                else {
+                    if (decode == null) {
+                        throw new Error(`Non-UTF-8 encoding '${encoding}' requested but no decode function configured`);
+                    }
+                    stdoutDecoded = await decode(Buffer.from(stdout, 'binary'), encoding ? { encoding: encoding } : undefined);
+                    stderrDecoded = await decode(Buffer.from(stderr, 'binary'), encoding ? { encoding: encoding } : undefined);
+                }
+                reject(new RunError(error, stdoutDecoded, stderrDecoded));
+                return;
+            }
+            if (stderr && !options?.quiet && scope?.enabled('debug')) {
+                scope?.warn(`[EXEC] '${command} ${args.join(' ')}' \u2022 ${stderr}`);
+            }
+            if (encoding === 'utf8' || encoding === 'binary' || encoding === 'buffer') {
+                resolve(stdout);
+            }
+            else {
+                if (decode == null) {
+                    throw new Error(`Non-UTF-8 encoding '${encoding}' requested but no decode function configured`);
+                }
+                resolve((await decode(Buffer.from(stdout, 'binary'), encoding ? { encoding: encoding } : undefined)));
+            }
+        });
+        if (stdin != null) {
+            proc.stdin?.end(stdin, (stdinEncoding ?? 'utf8'));
+        }
+    });
+    return promise.finally(() => scope?.[Symbol.dispose]());
+}
+export function runSpawn(command, args, encoding, options) {
+    const scope = getScopedLogger() ?? maybeStartScopedLogger('Exec.runSpawn');
+    const { stdin, stdinEncoding, cancellation, decode, ...opts } = options;
+    const promise = new Promise((resolve, reject) => {
+        const proc = spawn(command, args, { ...opts, signal: cancellation });
+        const errorEncoding = encoding === 'buffer' ? 'utf8' : encoding;
+        const stdoutBuffers = [];
+        proc.stdout.on('data', (data) => stdoutBuffers.push(data));
+        const stderrBuffers = [];
+        proc.stderr.on('data', (data) => stderrBuffers.push(data));
+        function getStdio(encoding) {
+            const stdout = Buffer.concat(stdoutBuffers);
+            const stderr = Buffer.concat(stderrBuffers);
+            if (encoding === 'utf8' || encoding === 'binary') {
+                return { stdout: stdout.toString(encoding), stderr: stderr.toString(encoding) };
+            }
+            if (encoding === 'buffer') {
+                return { stdout: stdout, stderr: stderr };
+            }
+            if (decode == null) {
+                throw new Error(`Non-UTF-8 encoding '${encoding}' requested but no decode function configured`);
+            }
+            return Promise.all([
+                decode(stdout, encoding ? { encoding: encoding } : undefined),
+                decode(stderr, encoding ? { encoding: encoding } : undefined),
+            ]).then(([decodedStdout, decodedStderr]) => ({
+                stdout: decodedStdout,
+                stderr: decodedStderr,
+            }));
+        }
+        proc.once('error', async (ex) => {
+            if (ex?.name === 'AbortError') {
+                reject(new CancelledRunError(`${command} ${args.join(' ')}`, true));
+                return;
+            }
+            const stdio = getStdio(errorEncoding);
+            const { stdout, stderr } = stdio instanceof Promise ? await stdio : stdio;
+            reject(new RunError(ex, stdout, stderr));
+        });
+        proc.once('close', async (code, signal) => {
+            if (options?.exitCodeOnly) {
+                resolve({ exitCode: code ?? 0 });
+                return;
+            }
+            if (code !== 0 || signal) {
+                const stdio = getStdio(errorEncoding);
+                const { stdout, stderr } = stdio instanceof Promise ? await stdio : stdio;
+                if (stderr.length && !options?.quiet && scope?.enabled('debug')) {
+                    scope?.warn(`[EXEC] '${command} ${args.join(' ')}' \u2022 ${stderr}`);
+                }
+                if (signal === 'SIGTERM') {
+                    reject(new CancelledRunError(`${command} ${args.join(' ')}`, true, code ?? undefined, signal));
+                    return;
+                }
+                reject(new RunError({
+                    message: `Command failed with exit code ${code}`,
+                    code: code,
+                    signal: signal ?? undefined,
+                }, stdout, stderr));
+                return;
+            }
+            const stdio = getStdio(encoding);
+            const { stdout, stderr } = stdio instanceof Promise ? await stdio : stdio;
+            if (stderr.length && !options?.quiet && scope?.enabled('debug')) {
+                scope?.warn(`[EXEC] '${command} ${args.join(' ')}' \u2022 ${typeof stderr === 'string' ? stderr : stderr.toString()}`);
+            }
+            resolve({ exitCode: code ?? 0, stdout: stdout, stderr: stderr });
+        });
+        if (stdin) {
+            if (typeof stdin === 'string') {
+                proc.stdin.end(stdin, (stdinEncoding ?? 'utf8'));
+            }
+            else if (stdin instanceof Buffer) {
+                proc.stdin.end(stdin);
+            }
+        }
+    });
+    return promise.finally(() => scope?.[Symbol.dispose]());
+}
+export async function fsExists(path) {
+    return new Promise(resolve => access(path, constants.F_OK, err => resolve(err == null)));
+}
+//# sourceMappingURL=exec.js.map

package/dist/utils/env/node/exec.js.map

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

package/dist/utils/env/node/fs.d.ts

@@ -0,0 +1,2 @@
+export declare function realpath(path: string): Promise<string>;
+//# sourceMappingURL=fs.d.ts.map

package/dist/utils/env/node/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../../src/env/node/fs.ts"],"names":[],"mappings":"AAEA,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEtD"}

package/dist/utils/env/node/fs.js

@@ -0,0 +1,5 @@
+import { realpath as _realpath } from 'fs/promises';
+export function realpath(path) {
+    return _realpath(path);
+}
+//# sourceMappingURL=fs.js.map

package/dist/utils/env/node/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../../src/env/node/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,UAAU,QAAQ,CAAC,IAAY;IACpC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC"}

package/dist/utils/env/node/hex.d.ts

@@ -0,0 +1,4 @@
+export declare function convertToHex(bytes: Uint8Array): string;
+export declare function encodeUtf8Hex(s: string): string;
+export declare function decodeUtf8Hex(hex: string): string;
+//# sourceMappingURL=hex.d.ts.map

package/dist/utils/env/node/hex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hex.d.ts","sourceRoot":"","sources":["../../../src/env/node/hex.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEtD;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/utils/env/node/hex.js

@@ -0,0 +1,10 @@
+export function convertToHex(bytes) {
+    return Buffer.from(bytes).toString('hex');
+}
+export function encodeUtf8Hex(s) {
+    return Buffer.from(s, 'utf8').toString('hex');
+}
+export function decodeUtf8Hex(hex) {
+    return Buffer.from(hex, 'hex').toString('utf8');
+}
+//# sourceMappingURL=hex.js.map

package/dist/utils/env/node/hex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hex.js","sourceRoot":"","sources":["../../../src/env/node/hex.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CAAC,KAAiB;IAC7C,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,CAAS;IACtC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAW;IACxC,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACjD,CAAC"}

package/dist/utils/env/node/hrtime.d.ts

@@ -0,0 +1,2 @@
+export { hrtime } from 'process';
+//# sourceMappingURL=hrtime.d.ts.map

package/dist/utils/env/node/hrtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hrtime.d.ts","sourceRoot":"","sources":["../../../src/env/node/hrtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC"}

package/dist/utils/env/node/hrtime.js

@@ -0,0 +1,2 @@
+export { hrtime } from 'process';
+//# sourceMappingURL=hrtime.js.map

package/dist/utils/env/node/hrtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hrtime.js","sourceRoot":"","sources":["../../../src/env/node/hrtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC"}

package/dist/utils/env/node/logScope.d.ts

@@ -0,0 +1,34 @@
+import type { ScopedLogger } from '../../logger.scoped.js';
+/**
+ * Runs a function within a log scope context.
+ * The scope will be available via getCurrentScope() throughout the async execution.
+ */
+export declare function runInScope<T>(scope: ScopedLogger, fn: () => T): T;
+/**
+ * Gets the current log scope from AsyncLocalStorage.
+ * Works correctly across async boundaries.
+ */
+export declare function getCurrentScope(): ScopedLogger | undefined;
+/**
+ * Enters a log scope context (for use with `using` pattern).
+ * The scope will be available via getCurrentScope() throughout async execution.
+ *
+ * Always creates a new store object via `enterWith` rather than mutating an existing store.
+ * This ensures concurrent async operations each retain their own store snapshot — existing
+ * async continuations that captured the previous store are unaffected by new `enterWith` calls.
+ * The previous store is linked via `prev` so that `exitScope` can propagate cleanup to
+ * parent async contexts.
+ */
+export declare function enterScope(scope: ScopedLogger): void;
+/**
+ * Exits a log scope context (for use with `using` pattern).
+ *
+ * Propagates the restored scope to all ancestor stores so parent async contexts
+ * (which captured older store snapshots) see the cleanup. Then creates a fresh store
+ * for the current execution context going forward.
+ *
+ * @param prevScope The scope to restore, or undefined to clear the current scope.
+ * @param _scopeToExit Unused in Node.js (AsyncLocalStorage handles cleanup automatically).
+ */
+export declare function exitScope(prevScope: ScopedLogger | undefined, _scopeToExit?: ScopedLogger): void;
+//# sourceMappingURL=logScope.d.ts.map

package/dist/utils/env/node/logScope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logScope.d.ts","sourceRoot":"","sources":["../../../src/env/node/logScope.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAU3D;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEjE;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,YAAY,GAAG,SAAS,CAE1D;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAGpD;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,YAAY,GAAG,SAAS,EAAE,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAUhG"}

package/dist/utils/env/node/logScope.js

@@ -0,0 +1,52 @@
+import { AsyncLocalStorage } from 'async_hooks';
+const scopeStorage = new AsyncLocalStorage();
+/**
+ * Runs a function within a log scope context.
+ * The scope will be available via getCurrentScope() throughout the async execution.
+ */
+export function runInScope(scope, fn) {
+    return scopeStorage.run({ current: scope, prev: undefined }, fn);
+}
+/**
+ * Gets the current log scope from AsyncLocalStorage.
+ * Works correctly across async boundaries.
+ */
+export function getCurrentScope() {
+    return scopeStorage.getStore()?.current;
+}
+/**
+ * Enters a log scope context (for use with `using` pattern).
+ * The scope will be available via getCurrentScope() throughout async execution.
+ *
+ * Always creates a new store object via `enterWith` rather than mutating an existing store.
+ * This ensures concurrent async operations each retain their own store snapshot — existing
+ * async continuations that captured the previous store are unaffected by new `enterWith` calls.
+ * The previous store is linked via `prev` so that `exitScope` can propagate cleanup to
+ * parent async contexts.
+ */
+export function enterScope(scope) {
+    const prevStore = scopeStorage.getStore();
+    scopeStorage.enterWith({ current: scope, prev: prevStore });
+}
+/**
+ * Exits a log scope context (for use with `using` pattern).
+ *
+ * Propagates the restored scope to all ancestor stores so parent async contexts
+ * (which captured older store snapshots) see the cleanup. Then creates a fresh store
+ * for the current execution context going forward.
+ *
+ * @param prevScope The scope to restore, or undefined to clear the current scope.
+ * @param _scopeToExit Unused in Node.js (AsyncLocalStorage handles cleanup automatically).
+ */
+export function exitScope(prevScope, _scopeToExit) {
+    // Walk the ancestor chain and propagate the restored scope to all parent stores.
+    // Parent async contexts captured these older store objects and read `.current` on resume,
+    // so they need to see the updated value.
+    let store = scopeStorage.getStore();
+    while (store != null) {
+        store.current = prevScope;
+        store = store.prev;
+    }
+    scopeStorage.enterWith({ current: prevScope, prev: scopeStorage.getStore()?.prev });
+}
+//# sourceMappingURL=logScope.js.map

package/dist/utils/env/node/logScope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logScope.js","sourceRoot":"","sources":["../../../src/env/node/logScope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAShD,MAAM,YAAY,GAAG,IAAI,iBAAiB,EAAc,CAAC;AAEzD;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAI,KAAmB,EAAE,EAAW;IAC7D,OAAO,YAAY,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;AAClE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC9B,OAAO,YAAY,CAAC,QAAQ,EAAE,EAAE,OAAO,CAAC;AACzC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CAAC,KAAmB;IAC7C,MAAM,SAAS,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC;IAC1C,YAAY,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CAAC,SAAmC,EAAE,YAA2B;IACzF,iFAAiF;IACjF,0FAA0F;IAC1F,yCAAyC;IACzC,IAAI,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC;IACpC,OAAO,KAAK,IAAI,IAAI,EAAE,CAAC;QACtB,KAAK,CAAC,OAAO,GAAG,SAAS,CAAC;QAC1B,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC;IACpB,CAAC;IACD,YAAY,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;AACrF,CAAC"}

package/dist/utils/env/node/platform.d.ts

@@ -0,0 +1,4 @@
+export declare const isWindows: boolean;
+export declare const isLinux: boolean;
+export declare const isMac: boolean;
+//# sourceMappingURL=platform.d.ts.map

package/dist/utils/env/node/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../../src/env/node/platform.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS,EAAE,OAA8B,CAAC;AACvD,eAAO,MAAM,OAAO,EAAE,OAA8B,CAAC;AACrD,eAAO,MAAM,KAAK,EAAE,OAA+B,CAAC"}

package/dist/utils/env/node/platform.js

@@ -0,0 +1,5 @@
+import { platform } from 'node:process';
+export const isWindows = platform === 'win32';
+export const isLinux = platform === 'linux';
+export const isMac = platform === 'darwin';
+//# sourceMappingURL=platform.js.map

package/dist/utils/env/node/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../../src/env/node/platform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,MAAM,CAAC,MAAM,SAAS,GAAY,QAAQ,KAAK,OAAO,CAAC;AACvD,MAAM,CAAC,MAAM,OAAO,GAAY,QAAQ,KAAK,OAAO,CAAC;AACrD,MAAM,CAAC,MAAM,KAAK,GAAY,QAAQ,KAAK,QAAQ,CAAC"}

package/dist/utils/error.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Duck-types an Error-like value. Catches native `Error`, subclasses, `DOMException`
+ * (thrown by `AbortSignal.throwIfAborted()`), and cross-realm Errors (which fail
+ * `instanceof Error` checks). Without this, `JSON.stringify(error)` serializes those
+ * shapes to `{}` since core properties are non-enumerable on the prototype.
+ */
+export declare function isErrorLike(v: unknown): v is {
+    name: string;
+    message: string;
+    stack?: string;
+};
+/** Returns the error's stack when available, otherwise `"<name>: <message>"`. */
+export declare function flattenError(v: {
+    name: string;
+    message: string;
+    stack?: string;
+}): string;
+//# sourceMappingURL=error.d.ts.map

package/dist/utils/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/utils/error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAK9F;AAED,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEzF"}

package/dist/utils/error.js

@@ -0,0 +1,19 @@
+/**
+ * Duck-types an Error-like value. Catches native `Error`, subclasses, `DOMException`
+ * (thrown by `AbortSignal.throwIfAborted()`), and cross-realm Errors (which fail
+ * `instanceof Error` checks). Without this, `JSON.stringify(error)` serializes those
+ * shapes to `{}` since core properties are non-enumerable on the prototype.
+ */
+export function isErrorLike(v) {
+    if (v == null || typeof v !== 'object')
+        return false;
+    if (v instanceof Error)
+        return true;
+    const o = v;
+    return typeof o.name === 'string' && typeof o.message === 'string';
+}
+/** Returns the error's stack when available, otherwise `"<name>: <message>"`. */
+export function flattenError(v) {
+    return v.stack ?? `${v.name}: ${v.message}`;
+}
+//# sourceMappingURL=error.js.map

package/dist/utils/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/utils/error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,CAAU;IACrC,IAAI,CAAC,IAAI,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,CAAC,YAAY,KAAK;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,CAAC,GAAG,CAA0C,CAAC;IACrD,OAAO,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC;AACpE,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,YAAY,CAAC,CAAoD;IAChF,OAAO,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;AAC7C,CAAC"}

package/dist/utils/event.d.ts

@@ -0,0 +1,59 @@
+import type { UnifiedDisposable } from './disposable.js';
+import type { Deferred } from './promise.js';
+export interface Event<T> {
+    (listener: (e: T) => any, thisArgs?: unknown, disposables?: {
+        dispose(): void;
+    }[]): UnifiedDisposable;
+}
+export declare class Emitter<T> {
+    private _listeners?;
+    private _event?;
+    private _disposed;
+    /**
+     * For the public to allow to subscribe
+     * to events from this Emitter
+     */
+    get event(): Event<T>;
+    /**
+     * To be kept private to fire an event to
+     * subscribers
+     */
+    fire(event: T): void;
+    dispose(): void;
+    [Symbol.dispose](): void;
+}
+/**
+ * Minimal event type compatible with both VS Code's `Event<T>` and `@gitkraken/core-gitlens/utils` `Event<T>`.
+ * Use this as the parameter type when a function should accept events from either source.
+ */
+export type EventLike<T> = (listener: (e: T) => any, thisArgs?: any, ...args: any[]) => {
+    dispose(): void;
+};
+export declare function once<T>(event: EventLike<T>, disposables?: {
+    dispose(): void;
+}[]): EventLike<T>;
+export declare function take<T>(event: EventLike<T>, count: number, disposables?: {
+    dispose(): void;
+}[]): EventLike<T>;
+export type DeferredEvent<T> = Omit<Deferred<T>, 'fulfill'>;
+export type DeferredEventExecutor<T, U> = (value: T, resolve: (value: U | PromiseLike<U>) => void, reject: (reason: any) => void) => any;
+/**
+ * Return a promise that resolves with the next emitted event, or with some future
+ * event as decided by an executor.
+ *
+ * If specified, the executor is a function that will be called with `(value, resolve, reject)`.
+ * It will be called once per event until it resolves or rejects.
+ *
+ * The default executor just resolves with the value.
+ *
+ * @param event the event
+ * @param executor controls resolution of the returned promise
+ * @returns a cancellable deferred promise that resolves or rejects as specified by the executor
+ */
+export declare function promisifyDeferred<T, U>(event: EventLike<T>, executor?: DeferredEventExecutor<T, U>): DeferredEvent<U>;
+export declare function weakEvent<T, U extends object>(event: EventLike<T>, listener: (e: T) => any, thisArg: U, alsoDisposeOnReleaseOrDispose?: {
+    dispose(): void;
+}[]): {
+    dispose(): void;
+};
+//# sourceMappingURL=event.d.ts.map

package/dist/utils/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/utils/event.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,WAAW,KAAK,CAAC,CAAC;IACvB,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,GAAG,EAAE,QAAQ,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE;QAAE,OAAO,IAAI,IAAI,CAAA;KAAE,EAAE,GAAG,iBAAiB,CAAC;CACtG;AAED,qBAAa,OAAO,CAAC,CAAC;IACrB,OAAO,CAAC,UAAU,CAAC,CAAoD;IACvE,OAAO,CAAC,MAAM,CAAC,CAAW;IAC1B,OAAO,CAAC,SAAS,CAAkB;IAEnC;;;OAGG;IACH,IAAI,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,CAgCpB;IAED;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAepB,OAAO,IAAI,IAAI;IAOf,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;CAGxB;AAED;;;GAGG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,GAAG,EAAE,QAAQ,CAAC,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK;IAAE,OAAO,IAAI,IAAI,CAAA;CAAE,CAAC;AAE5G,wBAAgB,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE;IAAE,OAAO,IAAI,IAAI,CAAA;CAAE,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAE9F;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE;IAAE,OAAO,IAAI,IAAI,CAAA;CAAE,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAiB7G;AAED,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;AAE5D,MAAM,MAAM,qBAAqB,CAAC,CAAC,EAAE,CAAC,IAAI,CACzC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,EAC5C,MAAM,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,KACzB,GAAG,CAAC;AAIT;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,CAAC,EACrC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EACnB,QAAQ,GAAE,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAmB,GACrD,aAAa,CAAC,CAAC,CAAC,CAyClB;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,EAC5C,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EACnB,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,GAAG,EACvB,OAAO,EAAE,CAAC,EACV,6BAA6B,CAAC,EAAE;IAAE,OAAO,IAAI,IAAI,CAAA;CAAE,EAAE,GACnD;IAAE,OAAO,IAAI,IAAI,CAAA;CAAE,CAiCrB"}