@anweat/dsh-browser 0.2.0 → 0.2.2

package/lib/deps.d.ts

@@ -2,11 +2,13 @@
  * Dependency resolution for dsh-browser, with reuse fallback.
  *
  * Resolution order (per dependency):
- *   1. THIS plugin's own node_modules — self-contained when distributed
- *      (playwright / @jackwener/opencli are declared in package.json).
+ *   1. THIS plugin's own node_modules — playwright / patchright are declared in package.json.
  *   2. The global npm root — reuse what's already installed on the machine,
  *      so a dev box needs zero extra install.
  *
+ * `@jackwener/opencli` is NOT declared: its install script makes pnpm 11 fail `dsh plugin add`. It is found
+ * wherever it is installed (see `locateOpencli`) and is only needed by the `opencli.*` actions.
+ *
  * The Playwright BROWSER BINARY (chromium) is NOT bundled here and NOT
  * re-downloaded: playwright loads it from its shared cache (Windows:
  * %LOCALAPPDATA%\ms-playwright), which this machine already has. So
@@ -31,10 +33,45 @@ export declare function loadPlaywright(): any;
 export declare function playwrightCliPath(): string;
 /** CLI entry for the selected Playwright-compatible runtime. */
 export declare function browserRuntimeCliPath(runtime: BrowserRuntimeName): string;
-/** Entry JS for the bundled/reused @jackwener/opencli (its bin/main). */
+/** Where `@jackwener/opencli` was found. */
+export type OpencliSource = 'env' | 'plugin' | 'path' | 'global-npm' | 'common-prefix';
+export interface OpencliLocation {
+    /** The JavaScript entry (`bin.opencli` of its package.json). Run with Node. */
+    entry: string;
+    /** The package directory. */
+    packageDir: string;
+    source: OpencliSource;
+}
+/**
+ * What to tell a user whose machine has no OpenCLI. OpenCLI is optional: the browser tools never need it, only the
+ * `opencli.*` actions do. It is NOT a dependency of this package, because its install scripts make pnpm 11 fail
+ * `dsh plugin add` (ERR_PNPM_IGNORED_BUILDS) on a profile that has not approved them.
+ */
+export declare const OPENCLI_INSTALL_HINT: string;
+/** Everything `locateOpencli` reads from the machine, so a test can describe a machine instead of owning one. */
+export interface OpencliSearchEnv {
+    platform: NodeJS.Platform;
+    env: NodeJS.ProcessEnv;
+    home: string;
+    /** package.json files of the dependency, in the order the plugin's own resolution finds them. */
+    pluginPackageJsons: () => string[];
+    /** `npm root -g`, or undefined when npm cannot be run. */
+    npmGlobalRoot: () => string | undefined;
+}
+/**
+ * Find OpenCLI without requiring it to be a dependency of the plugin. Order: `DSH_BROWSER_OPENCLI`, the plugin's own
+ * resolution (pnpm store, plugin-local, an `@jackwener/opencli` the user added to the profile), an `opencli` launcher on PATH,
+ * `npm root -g`, and the usual global locations. The first hit wins. Pure apart from reading the file system.
+ */
+export declare function locateOpencli(search: OpencliSearchEnv): OpencliLocation | undefined;
+/** Find OpenCLI on this machine. A hit is remembered while its files exist; a miss is looked up again (the user may install it while DSH runs). */
+export declare function opencliLocation(): OpencliLocation | undefined;
+/** What to tell the user when OpenCLI was not found: names a wrong `DSH_BROWSER_OPENCLI` first, since that one is theirs to fix. */
+export declare function opencliMissingMessage(): string;
+/** Entry JS of OpenCLI (its bin/main). Throws the install hint when OpenCLI is not installed. */
 export declare function opencliEntryPath(): string;
 /**
- * Run a Node.js script with piped stdio capture (bundled opencli / playwright
+ * Run a Node.js script with piped stdio capture (opencli / playwright
  * CLI). Mirrors web-search-pro's runCli contract.
  */
 export declare function runNode(script: string, args: string[], opts?: {
@@ -44,7 +81,7 @@ export declare function runNode(script: string, args: string[], opts?: {
     cwd?: string;
     env?: Record<string, string>;
 }): Promise<CliResult>;
-/** Run opencli (bundled or global-reuse). */
+/** Run opencli (found by `opencliLocation`). */
 export declare function runOpencli(args: string[], opts?: {
     timeoutMs?: number;
     signal: AbortSignal | undefined;

package/lib/deps.js

@@ -2,11 +2,13 @@
  * Dependency resolution for dsh-browser, with reuse fallback.
  *
  * Resolution order (per dependency):
- *   1. THIS plugin's own node_modules — self-contained when distributed
- *      (playwright / @jackwener/opencli are declared in package.json).
+ *   1. THIS plugin's own node_modules — playwright / patchright are declared in package.json.
  *   2. The global npm root — reuse what's already installed on the machine,
  *      so a dev box needs zero extra install.
  *
+ * `@jackwener/opencli` is NOT declared: its install script makes pnpm 11 fail `dsh plugin add`. It is found
+ * wherever it is installed (see `locateOpencli`) and is only needed by the `opencli.*` actions.
+ *
  * The Playwright BROWSER BINARY (chromium) is NOT bundled here and NOT
  * re-downloaded: playwright loads it from its shared cache (Windows:
  * %LOCALAPPDATA%\ms-playwright), which this machine already has. So
@@ -122,12 +124,220 @@ export function playwrightCliPath() {
 export function browserRuntimeCliPath(runtime) {
     return path.join(pkgDir(browserRuntimePackage(runtime)), 'cli.js');
 }
-/** Entry JS for the bundled/reused @jackwener/opencli (its bin/main). */
+/**
+ * What to tell a user whose machine has no OpenCLI. OpenCLI is optional: the browser tools never need it, only the
+ * `opencli.*` actions do. It is NOT a dependency of this package, because its install scripts make pnpm 11 fail
+ * `dsh plugin add` (ERR_PNPM_IGNORED_BUILDS) on a profile that has not approved them.
+ */
+export const OPENCLI_INSTALL_HINT = 'OpenCLI is not installed (it is optional: only the opencli.* actions need it). Install it with `npm i -g @jackwener/opencli` and restart DSH. '
+    + 'If DSH cannot see your PATH (desktop app), set DSH_BROWSER_OPENCLI to the path of its main.js.';
+const OPENCLI_PACKAGE = '@jackwener/opencli';
+/** Read `bin.opencli` (or `main`) of an opencli package directory and return its existing entry file. */
+function opencliEntryOf(packageDir) {
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(packageDir, 'package.json'), 'utf8'));
+        if (pkg?.name !== OPENCLI_PACKAGE)
+            return undefined;
+        const bin = typeof pkg.bin === 'string' ? pkg.bin : (pkg.bin?.opencli ?? pkg.main ?? 'dist/src/main.js');
+        const entry = path.join(packageDir, bin);
+        return fs.existsSync(entry) ? entry : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The opencli package directory a `main.js` / launcher path belongs to: walk up to the nearest package.json named for it. */
+function opencliPackageDirOf(file) {
+    let dir = path.dirname(file);
+    for (let i = 0; i < 8; i++) {
+        if (opencliEntryOf(dir))
+            return dir;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return undefined;
+        dir = parent;
+    }
+    return undefined;
+}
+/** `DSH_BROWSER_OPENCLI` may name the package directory, its main.js, or the `opencli` launcher. */
+function opencliFromPath(target) {
+    let resolved;
+    try {
+        resolved = fs.realpathSync(target);
+    }
+    catch {
+        return undefined;
+    }
+    let stat;
+    try {
+        stat = fs.statSync(resolved);
+    }
+    catch {
+        return undefined;
+    }
+    const packageDir = stat.isDirectory() ? (opencliEntryOf(resolved) ? resolved : undefined) : opencliPackageDirOf(resolved);
+    const entry = packageDir ? opencliEntryOf(packageDir) : undefined;
+    return packageDir && entry ? { entry, packageDir, source: 'env' } : undefined;
+}
+/** Launchers named `opencli` on PATH: a symlink into the package on Unix, a `.cmd` shim next to `node_modules` on Windows. */
+function opencliFromPathVariable(env, platform) {
+    const delimiter = platform === 'win32' ? ';' : ':';
+    const names = platform === 'win32' ? ['opencli.cmd', 'opencli.exe', 'opencli'] : ['opencli'];
+    for (const raw of (env.PATH ?? env.Path ?? env.path ?? '').split(delimiter)) {
+        const dir = raw.trim().replace(/^"|"$/g, '');
+        if (!dir)
+            continue;
+        for (const name of names) {
+            const launcher = path.join(dir, name);
+            if (!fs.existsSync(launcher))
+                continue;
+            // Unix: the launcher is a symlink to <package>/dist/src/main.js. Windows: the npm shim sits beside node_modules.
+            const viaLink = opencliPackageDirOf(safeRealpath(launcher) ?? launcher);
+            const packageDir = viaLink ?? (opencliEntryOf(path.join(dir, 'node_modules', OPENCLI_PACKAGE)) ? path.join(dir, 'node_modules', OPENCLI_PACKAGE) : undefined);
+            const entry = packageDir ? opencliEntryOf(packageDir) : undefined;
+            if (packageDir && entry)
+                return { entry, packageDir, source: 'path' };
+        }
+    }
+    return undefined;
+}
+function safeRealpath(file) {
+    try {
+        return fs.realpathSync(file);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Global `node_modules` directories a desktop app (which does not inherit the shell's PATH) is likely to need. */
+function commonGlobalRoots(env, platform, home) {
+    const roots = [];
+    const prefix = env.npm_config_prefix ?? env.NPM_CONFIG_PREFIX;
+    if (prefix)
+        roots.push(platform === 'win32' ? path.join(prefix, 'node_modules') : path.join(prefix, 'lib', 'node_modules'));
+    if (platform === 'win32') {
+        if (env.APPDATA)
+            roots.push(path.join(env.APPDATA, 'npm', 'node_modules'));
+        return roots;
+    }
+    roots.push('/opt/homebrew/lib/node_modules', '/usr/local/lib/node_modules', '/usr/lib/node_modules', path.join(home, '.npm-global', 'lib', 'node_modules'), path.join(home, '.local', 'lib', 'node_modules'), path.join(home, '.bun', 'install', 'global', 'node_modules'), path.join(home, '.volta', 'tools', 'image', 'packages', 'opencli', 'lib', 'node_modules'));
+    // Version managers keep one global root per Node version: take them all, newest directory name first.
+    const managed = [path.join(home, '.nvm', 'versions', 'node'), path.join(home, '.local', 'share', 'fnm', 'node-versions'), path.join(home, 'Library', 'Application Support', 'fnm', 'node-versions'), path.join(home, '.fnm', 'node-versions')];
+    for (const base of managed) {
+        let versions;
+        try {
+            versions = fs.readdirSync(base).sort().reverse();
+        }
+        catch {
+            continue;
+        }
+        for (const version of versions) {
+            roots.push(path.join(base, version, 'lib', 'node_modules'), path.join(base, version, 'installation', 'lib', 'node_modules'));
+        }
+    }
+    return roots;
+}
+/**
+ * Find OpenCLI without requiring it to be a dependency of the plugin. Order: `DSH_BROWSER_OPENCLI`, the plugin's own
+ * resolution (pnpm store, plugin-local, an `@jackwener/opencli` the user added to the profile), an `opencli` launcher on PATH,
+ * `npm root -g`, and the usual global locations. The first hit wins. Pure apart from reading the file system.
+ */
+export function locateOpencli(search) {
+    const override = search.env.DSH_BROWSER_OPENCLI?.trim();
+    if (override) {
+        const found = opencliFromPath(override);
+        if (found)
+            return found;
+        // An explicit override that does not resolve is reported by the caller; do not silently use another copy.
+        return undefined;
+    }
+    for (const pkgJson of search.pluginPackageJsons()) {
+        const packageDir = path.dirname(pkgJson);
+        const entry = opencliEntryOf(packageDir);
+        if (entry)
+            return { entry, packageDir, source: 'plugin' };
+    }
+    const viaPath = opencliFromPathVariable(search.env, search.platform);
+    if (viaPath)
+        return viaPath;
+    const globalRoot = search.npmGlobalRoot();
+    if (globalRoot) {
+        const packageDir = path.join(globalRoot, OPENCLI_PACKAGE);
+        const entry = opencliEntryOf(packageDir);
+        if (entry)
+            return { entry, packageDir, source: 'global-npm' };
+    }
+    for (const root of commonGlobalRoots(search.env, search.platform, search.home)) {
+        const packageDir = path.join(root, OPENCLI_PACKAGE);
+        const entry = opencliEntryOf(packageDir);
+        if (entry)
+            return { entry, packageDir, source: 'common-prefix' };
+    }
+    return undefined;
+}
+/** The plugin's own copies of opencli: pnpm's virtual store, then module resolution from the plugin root (the profile's hoisted node_modules). */
+function pluginOpencliPackageJsons() {
+    const found = [];
+    const store = pnpmStorePackageJson(OPENCLI_PACKAGE);
+    if (store)
+        found.push(store);
+    const req = createRequire(path.join(PLUGIN_ROOT, 'package.json'));
+    try {
+        found.push(req.resolve(OPENCLI_PACKAGE + '/package.json'));
+    }
+    catch { /* exports-restricted or absent */ }
+    try {
+        const root = findPackageRoot(req.resolve(OPENCLI_PACKAGE));
+        if (root)
+            found.push(root);
+    }
+    catch { /* absent */ }
+    return found;
+}
+let npmRootAsked = false;
+let npmRootValue;
+/** `npm root -g`, asked once per process (a spawn per status call would be slow), without the bogus Windows fallback when APPDATA is not set. */
+function npmGlobalRootOrUndefined() {
+    if (npmRootAsked)
+        return npmRootValue;
+    npmRootAsked = true;
+    try {
+        const root = execFileSync('npm', ['root', '-g'], { encoding: 'utf8', windowsHide: true, timeout: 15000 }).trim();
+        if (root)
+            npmRootValue = root;
+    }
+    catch { /* npm is not on PATH (a desktop app launched from the Dock has a minimal one) */ }
+    if (!npmRootValue && process.platform === 'win32' && process.env.APPDATA)
+        npmRootValue = path.join(process.env.APPDATA, 'npm', 'node_modules');
+    return npmRootValue;
+}
+let cachedOpencli;
+/** Find OpenCLI on this machine. A hit is remembered while its files exist; a miss is looked up again (the user may install it while DSH runs). */
+export function opencliLocation() {
+    const key = process.env.DSH_BROWSER_OPENCLI?.trim() ?? '';
+    if (cachedOpencli && cachedOpencli.key === key && fs.existsSync(cachedOpencli.location.entry))
+        return cachedOpencli.location;
+    const location = locateOpencli({
+        platform: process.platform,
+        env: process.env,
+        home: process.env.HOME ?? process.env.USERPROFILE ?? '',
+        pluginPackageJsons: pluginOpencliPackageJsons,
+        npmGlobalRoot: npmGlobalRootOrUndefined,
+    });
+    cachedOpencli = location ? { key, location } : undefined;
+    return location;
+}
+/** What to tell the user when OpenCLI was not found: names a wrong `DSH_BROWSER_OPENCLI` first, since that one is theirs to fix. */
+export function opencliMissingMessage() {
+    const override = process.env.DSH_BROWSER_OPENCLI?.trim();
+    return override ? `DSH_BROWSER_OPENCLI=${override} is not an OpenCLI package directory, its main.js or the opencli launcher: fix or unset it. ${OPENCLI_INSTALL_HINT}` : OPENCLI_INSTALL_HINT;
+}
+/** Entry JS of OpenCLI (its bin/main). Throws the install hint when OpenCLI is not installed. */
 export function opencliEntryPath() {
-    const dir = pkgDir('@jackwener/opencli');
-    const pkg = JSON.parse(fs.readFileSync(path.join(dir, 'package.json'), 'utf8'));
-    const bin = typeof pkg.bin === 'string' ? pkg.bin : (pkg.bin?.opencli ?? pkg.main ?? 'dist/src/main.js');
-    return path.join(dir, bin);
+    const location = opencliLocation();
+    if (!location)
+        throw new Error(opencliMissingMessage());
+    return location.entry;
 }
 /** Electron's process.execPath points to the desktop app, not a Node CLI. */
 function nodeExecutable(env) {
@@ -153,7 +363,7 @@ function nodeExecutable(env) {
     return undefined;
 }
 /**
- * Run a Node.js script with piped stdio capture (bundled opencli / playwright
+ * Run a Node.js script with piped stdio capture (opencli / playwright
  * CLI). Mirrors web-search-pro's runCli contract.
  */
 export function runNode(script, args, opts = { signal: undefined }) {
@@ -213,7 +423,7 @@ export function runNode(script, args, opts = { signal: undefined }) {
             opts.signal?.addEventListener('abort', onAbort);
     });
 }
-/** Run opencli (bundled or global-reuse). */
+/** Run opencli (found by `opencliLocation`). */
 export function runOpencli(args, opts = { signal: undefined }) {
     return runNode(opencliEntryPath(), args, opts);
 }

package/lib/deps.js.map

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

package/lib/downloads.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Download saving: file-name rules, collision-free placement inside `downloadDir`, and size-capped streaming.
+ *
+ * Everything that decides where a byte lands lives here, apart from the browser, so the rules are testable
+ * on their own: a name is reduced to a plain file name, a file never overwrites another, and the only
+ * directory a file can end up in is the configured one.
+ * @module dsh-browser/downloads
+ */
+/** How many download records a session keeps in memory (oldest dropped first). */
+export declare const DOWNLOAD_HISTORY_LIMIT = 50;
+/** What `inspect.downloads` reports for one download. The file itself is on disk; this record only lives in memory. */
+export interface DownloadRecord {
+    /** `d1`, `d2`, ... within the session. */
+    id: string;
+    /** The URL the download came from, with credential-looking query parameters masked. */
+    url: string;
+    /** `saved`, or `failed` (nothing is left on disk for a failed one). */
+    status: 'saved' | 'failed';
+    /** `request`: fetched by `target.download` with the session's cookies. `browser`: a download event of a page (navigation or click). */
+    source: 'request' | 'browser';
+    /** The name the server or page suggested. */
+    suggestedFilename: string;
+    /** Absolute path of the saved file (saved only). */
+    path?: string;
+    bytes?: number;
+    sha256?: string;
+    /** Why it failed (failed only). */
+    error?: string;
+    timestamp: string;
+}
+/** A download was cut because it passed `downloadMaxBytes`. */
+export declare class DownloadLimitError extends Error {
+    readonly maxBytes: number;
+    constructor(maxBytes: number);
+}
+/**
+ * Reduce a file name to a plain, portable one.
+ *
+ * `strict` is for a name the caller chose (`target.download` `filename`): anything that is not already a plain
+ * name is refused with INVALID_ARGS, so a path or a traversal never turns into a different file silently.
+ * Lenient is for a name a server or page suggested: only the last path segment is kept and unusable characters
+ * are replaced. Control characters are stripped in both. Returns '' when nothing usable is left (lenient only).
+ */
+export declare function sanitizeDownloadName(raw: string, strict: boolean): string;
+/** The name a download is saved under: the caller's (strict), else what the server suggested, else the URL's last segment. */
+export declare function resolveDownloadFilename(input: {
+    requested?: string;
+    suggested?: string;
+    url?: string;
+}): string;
+/** The last path segment of a URL, percent-decoded; '' when there is none. */
+export declare function downloadNameFromUrl(url: string): string;
+/** The file name of a Content-Disposition header (`filename*=UTF-8''...` first, then `filename=`); '' when absent. */
+export declare function contentDispositionFilename(header: string | undefined): string;
+/**
+ * Move a finished temporary file to its final name inside `dir`, never overwriting: a taken name gets
+ * `-1`, `-2`, ... before the extension. `name` must already be a plain file name (see {@link sanitizeDownloadName});
+ * this checks it again, because it is the last line before bytes become a path. Returns the absolute path.
+ */
+export declare function claimDownloadPath(dir: string, name: string, temporary: string): string;
+/** A fresh temporary file path inside `dir` (dot-prefixed, so a half-written file is not mistaken for a result). */
+export declare function temporaryDownloadPath(dir: string): string;
+/**
+ * Write a stream to `file`, counting bytes and hashing as they pass. Past `maxBytes` the source is destroyed
+ * and {@link DownloadLimitError} is thrown, so the caller deletes the partial file.
+ */
+export declare function streamToFile(source: NodeJS.ReadableStream & {
+    destroy?: (error?: Error) => void;
+}, file: string, maxBytes: number): Promise<{
+    bytes: number;
+    sha256: string;
+}>;
+/** Write an in-memory body to `file` with the same result shape as {@link streamToFile}. */
+export declare function writeBufferToFile(body: Buffer, file: string, maxBytes: number): {
+    bytes: number;
+    sha256: string;
+};
+/** Remove a file that may not exist; never throws. */
+export declare function removeQuietly(file: string | undefined): void;

package/lib/downloads.js

@@ -0,0 +1,189 @@
+/**
+ * Download saving: file-name rules, collision-free placement inside `downloadDir`, and size-capped streaming.
+ *
+ * Everything that decides where a byte lands lives here, apart from the browser, so the rules are testable
+ * on their own: a name is reduced to a plain file name, a file never overwrites another, and the only
+ * directory a file can end up in is the configured one.
+ * @module dsh-browser/downloads
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { ActionArgError } from "./actions/types.js";
+/** How many download records a session keeps in memory (oldest dropped first). */
+export const DOWNLOAD_HISTORY_LIMIT = 50;
+/** A download was cut because it passed `downloadMaxBytes`. */
+export class DownloadLimitError extends Error {
+    maxBytes;
+    constructor(maxBytes) {
+        super(`the download is larger than downloadMaxBytes (${maxBytes} bytes) ; the transfer was stopped and nothing was saved`);
+        this.maxBytes = maxBytes;
+        this.name = 'DownloadLimitError';
+    }
+}
+// Control characters, the bidirectional overrides that make "txt.exe" read as "exe.txt", and line separators.
+const INVISIBLE = /[\u0000-\u001f\u007f-\u009f\u200e\u200f\u2028\u2029\u202a-\u202e\u2066-\u2069]/g;
+// What Windows refuses in a name; refused everywhere so a file is portable.
+const WINDOWS_INVALID = /[<>:"|?*]/;
+const WINDOWS_INVALID_ALL = /[<>:"|?*]/g;
+const WINDOWS_RESERVED = /^(con|prn|aux|nul|com[0-9]|lpt[0-9])$/i;
+const MAX_NAME_CHARS = 180;
+function limitLength(name) {
+    if (name.length <= MAX_NAME_CHARS)
+        return name;
+    const extension = path.extname(name);
+    const keep = extension.length > 0 && extension.length <= 20 ? extension : '';
+    return name.slice(0, MAX_NAME_CHARS - keep.length) + keep;
+}
+/**
+ * Reduce a file name to a plain, portable one.
+ *
+ * `strict` is for a name the caller chose (`target.download` `filename`): anything that is not already a plain
+ * name is refused with INVALID_ARGS, so a path or a traversal never turns into a different file silently.
+ * Lenient is for a name a server or page suggested: only the last path segment is kept and unusable characters
+ * are replaced. Control characters are stripped in both. Returns '' when nothing usable is left (lenient only).
+ */
+export function sanitizeDownloadName(raw, strict) {
+    const fail = (message) => { throw new ActionArgError(`filename ${message}`, 'Pass a plain file name such as report.pdf; the directory is the downloadDir configuration.'); };
+    let name = String(raw).replace(INVISIBLE, '');
+    if (strict && /[\\/]/.test(name))
+        fail('must be a plain file name, not a path (no / or \\)');
+    if (!strict)
+        name = name.split(/[\\/]/).pop() ?? '';
+    if (strict && WINDOWS_INVALID.test(name))
+        fail('must not contain any of < > : " | ? *');
+    name = name.replace(WINDOWS_INVALID_ALL, '_');
+    // Trailing dots and spaces are dropped by Windows, so "a.pdf." and "a.pdf" would otherwise be two names for one file.
+    name = name.trim().replace(/[. ]+$/, '');
+    if (!name || name === '.' || name === '..' || /^\.+$/.test(name)) {
+        if (strict)
+            fail('must not be empty, "." or ".."');
+        return '';
+    }
+    if (WINDOWS_RESERVED.test(name.split('.')[0])) {
+        if (strict)
+            fail(`"${name}" is a reserved device name`);
+        name = '_' + name;
+    }
+    return limitLength(name);
+}
+/** The name a download is saved under: the caller's (strict), else what the server suggested, else the URL's last segment. */
+export function resolveDownloadFilename(input) {
+    if (input.requested !== undefined)
+        return sanitizeDownloadName(input.requested, true);
+    return sanitizeDownloadName(input.suggested ?? '', false)
+        || sanitizeDownloadName(downloadNameFromUrl(input.url ?? ''), false)
+        || 'download';
+}
+/** The last path segment of a URL, percent-decoded; '' when there is none. */
+export function downloadNameFromUrl(url) {
+    try {
+        const last = new URL(url).pathname.split('/').filter(Boolean).pop() ?? '';
+        return decodeURIComponent(last);
+    }
+    catch {
+        return '';
+    }
+}
+/** The file name of a Content-Disposition header (`filename*=UTF-8''...` first, then `filename=`); '' when absent. */
+export function contentDispositionFilename(header) {
+    if (!header)
+        return '';
+    const extended = /filename\*\s*=\s*([^']*)'[^']*'([^;]+)/i.exec(header);
+    if (extended) {
+        try {
+            return decodeURIComponent(extended[2].trim().replace(/^"|"$/g, ''));
+        }
+        catch { /* fall through to the plain form */ }
+    }
+    const quoted = /filename\s*=\s*"((?:[^"\\]|\\.)*)"/i.exec(header);
+    if (quoted)
+        return quoted[1].replace(/\\(.)/g, '$1');
+    const bare = /filename\s*=\s*([^;]+)/i.exec(header);
+    return bare ? bare[1].trim() : '';
+}
+/**
+ * Move a finished temporary file to its final name inside `dir`, never overwriting: a taken name gets
+ * `-1`, `-2`, ... before the extension. `name` must already be a plain file name (see {@link sanitizeDownloadName});
+ * this checks it again, because it is the last line before bytes become a path. Returns the absolute path.
+ */
+export function claimDownloadPath(dir, name, temporary) {
+    const root = path.resolve(dir);
+    if (name !== path.basename(name) || name === '' || name === '.' || name === '..' || /[\\/]/.test(name)) {
+        throw new Error(`refusing to save outside the download directory: ${JSON.stringify(name)}`);
+    }
+    const extension = path.extname(name);
+    const stem = extension ? name.slice(0, -extension.length) : name;
+    for (let attempt = 0; attempt < 10_000; attempt++) {
+        const candidate = path.join(root, attempt === 0 ? name : `${stem}-${attempt}${extension}`);
+        if (path.dirname(candidate) !== root)
+            throw new Error(`refusing to save outside the download directory: ${JSON.stringify(name)}`);
+        try {
+            // A hard link either takes the name or fails: it is the one atomic "create unless it exists".
+            fs.linkSync(temporary, candidate);
+        }
+        catch (error) {
+            const code = error.code;
+            if (code === 'EEXIST')
+                continue;
+            // File systems without hard links: an exclusive copy gives the same guarantee.
+            try {
+                fs.copyFileSync(temporary, candidate, fs.constants.COPYFILE_EXCL);
+            }
+            catch (copyError) {
+                if (copyError.code === 'EEXIST')
+                    continue;
+                throw copyError;
+            }
+        }
+        fs.unlinkSync(temporary);
+        return candidate;
+    }
+    throw new Error(`could not find a free file name for ${JSON.stringify(name)} in the download directory`);
+}
+/** A fresh temporary file path inside `dir` (dot-prefixed, so a half-written file is not mistaken for a result). */
+export function temporaryDownloadPath(dir) {
+    return path.join(path.resolve(dir), `.part-${crypto.randomUUID().slice(0, 12)}`);
+}
+/**
+ * Write a stream to `file`, counting bytes and hashing as they pass. Past `maxBytes` the source is destroyed
+ * and {@link DownloadLimitError} is thrown, so the caller deletes the partial file.
+ */
+export async function streamToFile(source, file, maxBytes) {
+    const hash = crypto.createHash('sha256');
+    const handle = await fs.promises.open(file, 'wx');
+    let bytes = 0;
+    try {
+        for await (const chunk of source) {
+            const buffer = typeof chunk === 'string' ? Buffer.from(chunk) : chunk;
+            bytes += buffer.length;
+            if (bytes > maxBytes) {
+                source.destroy?.();
+                throw new DownloadLimitError(maxBytes);
+            }
+            hash.update(buffer);
+            await handle.write(buffer);
+        }
+    }
+    finally {
+        await handle.close();
+    }
+    return { bytes, sha256: hash.digest('hex') };
+}
+/** Write an in-memory body to `file` with the same result shape as {@link streamToFile}. */
+export function writeBufferToFile(body, file, maxBytes) {
+    if (body.length > maxBytes)
+        throw new DownloadLimitError(maxBytes);
+    fs.writeFileSync(file, body, { flag: 'wx' });
+    return { bytes: body.length, sha256: crypto.createHash('sha256').update(body).digest('hex') };
+}
+/** Remove a file that may not exist; never throws. */
+export function removeQuietly(file) {
+    if (!file)
+        return;
+    try {
+        fs.unlinkSync(file);
+    }
+    catch { /* already gone */ }
+}
+//# sourceMappingURL=downloads.js.map