runpane 2.2.9

package/README.md

@@ -0,0 +1,60 @@
+# runpane
+
+Thin npm installer and remote setup CLI for Pane.
+
+The package does not include the Pane desktop runtime. It downloads the correct
+Pane release artifact only when you run `runpane install` or `runpane update`.
+
+## Usage
+
+One-shot install:
+
+```bash
+npx --yes runpane@latest install client
+npx --yes runpane@latest install daemon --label "My Server"
+pnpm dlx runpane@latest install daemon --label "My Server"
+```
+
+Persistent install:
+
+```bash
+npm i -g runpane
+runpane install daemon --label "My Server"
+
+pnpm add -g runpane
+runpane install daemon --label "My Server"
+```
+
+Compatible runners:
+
+```bash
+yarn dlx runpane@latest install daemon --label "My Server"
+bunx runpane@latest install daemon --label "My Server"
+```
+
+## Commands
+
+```bash
+runpane install
+runpane install client
+runpane install daemon
+runpane update
+runpane version
+runpane doctor
+runpane --help
+```
+
+`runpane install daemon` installs Pane and then invokes the installed executable
+with `--remote-setup`, preserving the `pane-remote://...` connection-code output.
+
+## Attribution
+
+npm package downloads use `source=npm` when requesting release artifacts from
+`runpane.com/api/download`. If that route is unavailable, the CLI falls back to
+matching GitHub release assets and prints a warning.
+
+## Publishing
+
+This package should be published through npm Trusted Publishing from GitHub
+Actions. Token-based `NPM_TOKEN` publishing is a fallback for first package
+reservation or manual publication only.

package/dist/cli.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { type ParsedArgs } from './commands';
+export declare function main(argv: string[]): Promise<number>;
+export declare function installOrUpdate(parsed: ParsedArgs): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAA8B,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAgBzE,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAsB1D;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CA0CzE"}

package/dist/cli.js

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.main = main;
+exports.installOrUpdate = installOrUpdate;
+const commands_1 = require("./commands");
+const download_1 = require("./download");
+const doctor_1 = require("./doctor");
+const installers_1 = require("./installers");
+const platform_1 = require("./platform");
+const releases_1 = require("./releases");
+const version_1 = require("./version");
+const SOURCE = 'npm';
+async function main(argv) {
+    const parsed = (0, commands_1.parseRunpaneArgs)(argv);
+    if (parsed.command === 'help') {
+        console.log((0, commands_1.helpText)(parsed.helpTopic));
+        return 0;
+    }
+    if (parsed.command === 'version') {
+        return (0, version_1.printVersion)(parsed.panePath);
+    }
+    if (parsed.command === 'doctor') {
+        return (0, doctor_1.runDoctor)(parsed, SOURCE);
+    }
+    if (parsed.command === 'install' || parsed.command === 'update') {
+        return installOrUpdate(parsed);
+    }
+    console.log((0, commands_1.helpText)());
+    return 0;
+}
+async function installOrUpdate(parsed) {
+    const target = parsed.command === 'update' ? 'client' : parsed.target;
+    if (!parsed.dryRun && (0, installers_1.shouldReuseExistingPane)(parsed, target)) {
+        const existing = (0, installers_1.resolveExistingPanePath)(parsed.panePath);
+        if (existing) {
+            return (0, installers_1.spawnPane)(existing, ['--remote-setup', ...parsed.remoteSetupArgs]);
+        }
+    }
+    const platform = (0, platform_1.detectPlatform)();
+    const resolved = await (0, releases_1.resolveRelease)({
+        version: parsed.paneVersion,
+        channel: parsed.channel,
+        source: SOURCE,
+        platform,
+        format: parsed.format,
+        target
+    });
+    if (parsed.dryRun) {
+        printDryRun(parsed, resolved.artifact.name, resolved.preferredDownloadUrl, resolved.fallbackDownloadUrl);
+        return 0;
+    }
+    const artifact = await (0, download_1.downloadArtifact)(resolved, parsed.downloadDir, parsed.verbose);
+    const installed = await (0, installers_1.installPaneArtifact)(artifact, {
+        parsed,
+        platform,
+        format: resolved.format,
+        target
+    });
+    if (target === 'daemon') {
+        return (0, installers_1.spawnPane)(installed.executablePath, ['--remote-setup', ...parsed.remoteSetupArgs]);
+    }
+    if (installed.installKind === 'installed') {
+        (0, installers_1.launchPaneClient)(installed.executablePath);
+    }
+    console.log(`Pane ${installed.installKind === 'existing' ? 'found' : 'installed'}: ${installed.executablePath}`);
+    return 0;
+}
+function printDryRun(parsed, artifactName, preferredDownloadUrl, fallbackDownloadUrl) {
+    const target = parsed.command === 'update' ? 'client' : parsed.target;
+    console.log('runpane dry run');
+    console.log(`Command: ${parsed.command}`);
+    console.log(`Target: ${target}`);
+    console.log(`Pane release: ${parsed.paneVersion}`);
+    console.log(`Channel: ${parsed.channel}`);
+    console.log(`Format: ${parsed.format}`);
+    console.log(`Artifact: ${artifactName}`);
+    console.log(`Preferred download: ${preferredDownloadUrl}`);
+    console.log(`GitHub fallback: ${fallbackDownloadUrl}`);
+    if (parsed.panePath) {
+        console.log(`Existing Pane path: ${parsed.panePath}`);
+    }
+    if (target === 'daemon') {
+        console.log(`Pane command: <pane executable> --remote-setup ${parsed.remoteSetupArgs.join(' ')}`.trim());
+    }
+}
+if (require.main === module) {
+    main(process.argv.slice(2)).then((code) => {
+        process.exitCode = code;
+    }).catch((error) => {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands.d.ts

@@ -0,0 +1,20 @@
+export type RunpaneCommand = 'help' | 'install' | 'update' | 'version' | 'doctor';
+export type InstallTarget = 'client' | 'daemon';
+export type ArtifactFormat = 'auto' | 'appimage' | 'deb' | 'dmg' | 'zip' | 'exe';
+export interface ParsedArgs {
+    command: RunpaneCommand;
+    helpTopic?: string;
+    target: InstallTarget;
+    paneVersion: string;
+    channel: 'stable' | 'nightly';
+    format: ArtifactFormat;
+    downloadDir?: string;
+    panePath?: string;
+    dryRun: boolean;
+    yes: boolean;
+    verbose: boolean;
+    remoteSetupArgs: string[];
+}
+export declare function parseRunpaneArgs(argv: string[]): ParsedArgs;
+export declare function helpText(topic?: string): string;
+//# sourceMappingURL=commands.d.ts.map

package/dist/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAClF,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAChD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAEjF,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC9B,MAAM,EAAE,cAAc,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAqCD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA4C3D;AAuGD,wBAAgB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAiF/C"}

package/dist/commands.js

@@ -0,0 +1,242 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseRunpaneArgs = parseRunpaneArgs;
+exports.helpText = helpText;
+const COMMANDS = new Set(['help', 'install', 'update', 'version', 'doctor']);
+const TARGETS = new Set(['client', 'daemon']);
+const FORMATS = new Set(['auto', 'appimage', 'deb', 'dmg', 'zip', 'exe']);
+const CHANNELS = new Set(['stable', 'nightly']);
+const REMOTE_VALUE_FLAGS = new Set([
+    '--label',
+    '--prefer-tunnel',
+    '--channel',
+    '--base-url',
+    '--pane-dir',
+    '--listen-port',
+    '--port',
+    '--repo-ref'
+]);
+const REMOTE_BOOLEAN_FLAGS = new Set([
+    '--auto-listen-port',
+    '--interactive-tailscale-setup',
+    '--no-install-service',
+    '--no-tailscale-serve',
+    '--print-only'
+]);
+const DEFAULTS = {
+    target: 'client',
+    paneVersion: 'latest',
+    channel: 'stable',
+    format: 'auto',
+    dryRun: false,
+    yes: false,
+    verbose: false,
+    remoteSetupArgs: []
+};
+function parseRunpaneArgs(argv) {
+    const args = [...argv];
+    const first = args.shift();
+    if (!first || first === '-h' || first === '--help') {
+        return { command: 'help', ...DEFAULTS };
+    }
+    if (first === '-v' || first === '--version') {
+        return { command: 'version', ...DEFAULTS };
+    }
+    if (!COMMANDS.has(first)) {
+        throw new Error(`Unknown command: ${first}\n\n${helpText()}`);
+    }
+    if (first === 'help') {
+        return {
+            command: 'help',
+            helpTopic: args[0],
+            ...DEFAULTS
+        };
+    }
+    const parsed = {
+        command: first,
+        ...DEFAULTS,
+        remoteSetupArgs: []
+    };
+    if (parsed.command === 'install' && args[0] && !args[0].startsWith('-')) {
+        const target = args.shift();
+        if (!target || !TARGETS.has(target)) {
+            throw new Error(`Unknown install target: ${target ?? ''}. Expected "client" or "daemon".`);
+        }
+        parsed.target = target;
+    }
+    if (parsed.command === 'update') {
+        parsed.target = 'client';
+    }
+    parseFlags(args, parsed);
+    return parsed;
+}
+function parseFlags(args, parsed) {
+    for (let index = 0; index < args.length; index++) {
+        const arg = args[index];
+        if (arg === '-h' || arg === '--help') {
+            const topic = parsed.command;
+            parsed.command = 'help';
+            parsed.helpTopic = topic;
+            continue;
+        }
+        if (arg === '--dry-run') {
+            parsed.dryRun = true;
+            continue;
+        }
+        if (arg === '--yes' || arg === '-y') {
+            parsed.yes = true;
+            continue;
+        }
+        if (arg === '--verbose') {
+            parsed.verbose = true;
+            continue;
+        }
+        if (arg === '--version') {
+            parsed.paneVersion = readValue(args, ++index, arg);
+            continue;
+        }
+        if (arg === '--download-dir') {
+            parsed.downloadDir = readValue(args, ++index, arg);
+            continue;
+        }
+        if (arg === '--pane-path') {
+            parsed.panePath = readValue(args, ++index, arg);
+            continue;
+        }
+        if (arg === '--format') {
+            const value = readValue(args, ++index, arg);
+            if (!FORMATS.has(value)) {
+                throw new Error(`Invalid --format "${value}". Expected one of: ${[...FORMATS].join(', ')}`);
+            }
+            parsed.format = value;
+            continue;
+        }
+        if (REMOTE_VALUE_FLAGS.has(arg)) {
+            const value = readValue(args, ++index, arg);
+            if (arg === '--channel') {
+                if (!CHANNELS.has(value)) {
+                    throw new Error(`Invalid --channel "${value}". Expected stable or nightly.`);
+                }
+                parsed.channel = value;
+            }
+            appendRemoteArg(parsed, arg, value);
+            continue;
+        }
+        if (REMOTE_BOOLEAN_FLAGS.has(arg)) {
+            appendRemoteArg(parsed, arg);
+            continue;
+        }
+        if (parsed.command === 'install' && parsed.target === 'daemon') {
+            index = appendUnknownRemoteArg(args, index, parsed, arg);
+            continue;
+        }
+        throw new Error(`Unknown option for ${parsed.command}: ${arg}`);
+    }
+}
+function appendRemoteArg(parsed, flag, value) {
+    if (parsed.command === 'install' && parsed.target === 'daemon') {
+        parsed.remoteSetupArgs.push(flag);
+        if (value !== undefined) {
+            parsed.remoteSetupArgs.push(value);
+        }
+        return;
+    }
+    if (REMOTE_VALUE_FLAGS.has(flag) || REMOTE_BOOLEAN_FLAGS.has(flag)) {
+        throw new Error(`${flag} is only valid with "runpane install daemon".`);
+    }
+}
+function appendUnknownRemoteArg(args, index, parsed, arg) {
+    parsed.remoteSetupArgs.push(arg);
+    const next = args[index + 1];
+    if (arg.startsWith('-') && next && !next.startsWith('-')) {
+        parsed.remoteSetupArgs.push(next);
+        return index + 1;
+    }
+    return index;
+}
+function readValue(args, index, flag) {
+    const value = args[index];
+    if (!value || value.startsWith('-')) {
+        throw new Error(`${flag} requires a value.`);
+    }
+    return value;
+}
+function helpText(topic) {
+    if (topic === 'install') {
+        return [
+            'Usage:',
+            '  runpane install [client|daemon] [options]',
+            '',
+            'Examples:',
+            '  npx --yes runpane@latest install client',
+            '  npx --yes runpane@latest install daemon --label "My Server"',
+            '  pnpm dlx runpane@latest install daemon --prefer-tunnel ssh --label "VM"',
+            '',
+            'Wrapper options:',
+            '  --version <latest|vX.Y.Z>        Pane release to install',
+            '  --format <auto|appimage|deb|dmg|zip|exe>',
+            '  --download-dir <path>',
+            '  --pane-path <path>               Use an existing Pane executable',
+            '  --dry-run                       Print the plan without downloading',
+            '  --yes                           Skip interactive prompts where possible',
+            '  --verbose',
+            '',
+            'Daemon passthrough options:',
+            '  --label <name>',
+            '  --prefer-tunnel <tailscale|ssh|manual|auto>',
+            '  --channel <stable|nightly>',
+            '  --base-url <url>',
+            '  --pane-dir <path>',
+            '  --listen-port <port> / --port <port>',
+            '  --auto-listen-port',
+            '  --interactive-tailscale-setup',
+            '  --no-install-service',
+            '  --no-tailscale-serve',
+            '  --print-only',
+            '  --repo-ref <ref>'
+        ].join('\n');
+    }
+    if (topic === 'update') {
+        return [
+            'Usage:',
+            '  runpane update [options]',
+            '',
+            'Updates Pane using the same artifact selection as "runpane install client".',
+            '',
+            'Options:',
+            '  --version <latest|vX.Y.Z>',
+            '  --format <auto|appimage|deb|dmg|zip|exe>',
+            '  --download-dir <path>',
+            '  --pane-path <path>',
+            '  --dry-run',
+            '  --yes',
+            '  --verbose'
+        ].join('\n');
+    }
+    if (topic === 'version') {
+        return 'Usage:\n  runpane version\n  runpane --version';
+    }
+    if (topic === 'doctor') {
+        return 'Usage:\n  runpane doctor [--pane-path <path>] [--format <format>] [--verbose]';
+    }
+    return [
+        'Usage:',
+        '  runpane install [client|daemon] [options]',
+        '  runpane update [options]',
+        '  runpane version',
+        '  runpane doctor',
+        '  runpane help [command]',
+        '',
+        'Package manager examples:',
+        '  npx --yes runpane@latest install daemon --label "My Server"',
+        '  pnpm dlx runpane@latest install daemon --label "My Server"',
+        '  npm i -g runpane && runpane install daemon --label "My Server"',
+        '',
+        'Python package equivalents:',
+        '  pipx run runpane install daemon --label "My Server"',
+        '  uvx runpane@latest install daemon --label "My Server"',
+        '',
+        'Run "runpane help install" for install options.'
+    ].join('\n');
+}
+//# sourceMappingURL=commands.js.map

package/dist/commands.js.map

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

package/dist/doctor.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedArgs } from './commands';
+export declare function runDoctor(parsed: ParsedArgs, source?: 'npm' | 'pip'): Promise<number>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM7C,wBAAsB,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,GAAE,KAAK,GAAG,KAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAkClG"}

package/dist/doctor.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runDoctor = runDoctor;
+const installers_1 = require("./installers");
+const platform_1 = require("./platform");
+const releases_1 = require("./releases");
+const version_1 = require("./version");
+async function runDoctor(parsed, source = 'npm') {
+    let ok = true;
+    try {
+        const platform = (0, platform_1.detectPlatform)();
+        console.log(`Platform: ${platform.os}/${platform.arch}`);
+        const release = await (0, releases_1.resolveRelease)({
+            version: parsed.paneVersion,
+            channel: parsed.channel,
+            source,
+            platform,
+            format: parsed.format,
+            target: 'client'
+        });
+        console.log(`Latest release: ${release.release.tag_name}`);
+        console.log(`Selected artifact: ${release.artifact.name}`);
+        console.log(`Website URL: ${release.preferredDownloadUrl}`);
+        console.log(`GitHub fallback: ${release.fallbackDownloadUrl}`);
+    }
+    catch (error) {
+        ok = false;
+        console.error(`Release check: failed - ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const installedPath = (0, installers_1.resolveExistingPanePath)(parsed.panePath);
+    if (installedPath) {
+        console.log(`Installed Pane: ${installedPath}`);
+        console.log(`Installed version: ${(0, version_1.getPaneVersion)(installedPath) ?? 'unknown'}`);
+    }
+    else {
+        console.log('Installed Pane: not found');
+    }
+    console.log('Remote setup: run "runpane install daemon --label <name>" to configure a headless host.');
+    return ok ? 0 : 1;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":";;AAMA,8BAkCC;AAvCD,6CAAuD;AACvD,yCAA4C;AAC5C,yCAA4C;AAC5C,uCAA2C;AAEpC,KAAK,UAAU,SAAS,CAAC,MAAkB,EAAE,SAAwB,KAAK;IAC/E,IAAI,EAAE,GAAG,IAAI,CAAC;IAEd,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAA,yBAAc,GAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,aAAa,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAEzD,MAAM,OAAO,GAAG,MAAM,IAAA,yBAAc,EAAC;YACnC,OAAO,EAAE,MAAM,CAAC,WAAW;YAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,MAAM;YACN,QAAQ;YACR,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,mBAAmB,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC3D,OAAO,CAAC,GAAG,CAAC,sBAAsB,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3D,OAAO,CAAC,GAAG,CAAC,gBAAgB,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,oBAAoB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;IACjE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,EAAE,GAAG,KAAK,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,2BAA2B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACrG,CAAC;IAED,MAAM,aAAa,GAAG,IAAA,oCAAuB,EAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/D,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,mBAAmB,aAAa,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAA,wBAAc,EAAC,aAAa,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC;IAClF,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,yFAAyF,CAAC,CAAC;IACvG,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC"}

package/dist/download.d.ts

@@ -0,0 +1,8 @@
+import { type ResolvedRelease } from './releases';
+export interface DownloadedArtifact {
+    path: string;
+    fileName: string;
+    usedFallback: boolean;
+}
+export declare function downloadArtifact(resolved: ResolvedRelease, downloadDir?: string, verbose?: boolean): Promise<DownloadedArtifact>;
+//# sourceMappingURL=download.d.ts.map

package/dist/download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../src/download.ts"],"names":[],"mappings":"AAOA,OAAO,EAAoB,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAEpE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,eAAe,EACzB,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,UAAQ,GACd,OAAO,CAAC,kBAAkB,CAAC,CAkB7B"}

package/dist/download.js

@@ -0,0 +1,84 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadArtifact = downloadArtifact;
+const crypto_1 = __importDefault(require("crypto"));
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const stream_1 = require("stream");
+const promises_1 = require("stream/promises");
+const releases_1 = require("./releases");
+async function downloadArtifact(resolved, downloadDir, verbose = false) {
+    const targetDir = downloadDir ?? path_1.default.join(os_1.default.tmpdir(), `runpane-${Date.now()}`);
+    fs_1.default.mkdirSync(targetDir, { recursive: true });
+    const fileName = (0, releases_1.artifactFileName)(resolved.artifact.name);
+    const targetPath = path_1.default.join(targetDir, fileName);
+    let usedFallback = false;
+    try {
+        await downloadToFile(resolved.preferredDownloadUrl, targetPath, verbose);
+    }
+    catch (error) {
+        usedFallback = true;
+        console.warn(`runpane: website download route failed; falling back to GitHub release asset. ${formatError(error)}`);
+        await downloadToFile(resolved.fallbackDownloadUrl, targetPath, verbose);
+    }
+    await verifyChecksumIfAvailable(resolved, targetPath, fileName);
+    return { path: targetPath, fileName, usedFallback };
+}
+async function downloadToFile(url, targetPath, verbose) {
+    if (verbose) {
+        console.log(`Downloading ${url}`);
+    }
+    const response = await fetch(url, {
+        redirect: 'follow',
+        headers: { 'user-agent': 'runpane-installer' }
+    });
+    if (!response.ok || !response.body) {
+        throw new Error(`${response.status} ${response.statusText}`);
+    }
+    await (0, promises_1.pipeline)(stream_1.Readable.fromWeb(response.body), fs_1.default.createWriteStream(targetPath));
+}
+async function verifyChecksumIfAvailable(resolved, artifactPath, fileName) {
+    try {
+        const response = await fetch(resolved.checksumUrl, {
+            headers: { 'user-agent': 'runpane-installer' }
+        });
+        if (!response.ok) {
+            return;
+        }
+        const checksums = await response.text();
+        const expected = parseChecksum(checksums, fileName);
+        if (!expected) {
+            return;
+        }
+        const hash = crypto_1.default.createHash('sha256').update(fs_1.default.readFileSync(artifactPath)).digest('hex');
+        if (hash.toLowerCase() !== expected.toLowerCase()) {
+            throw new Error(`Checksum mismatch for ${fileName}. Expected ${expected}, got ${hash}.`);
+        }
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.startsWith('Checksum mismatch')) {
+            throw error;
+        }
+        console.warn(`runpane: could not verify checksum for ${fileName}. ${formatError(error)}`);
+    }
+}
+function parseChecksum(checksums, fileName) {
+    for (const line of checksums.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (!trimmed.endsWith(fileName))
+            continue;
+        const [hash] = trimmed.split(/\s+/);
+        if (/^[a-f0-9]{64}$/i.test(hash)) {
+            return hash;
+        }
+    }
+    return undefined;
+}
+function formatError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=download.js.map

package/dist/download.js.map

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

package/dist/installers.d.ts

@@ -0,0 +1,18 @@
+import type { ArtifactFormat, InstallTarget, ParsedArgs } from './commands';
+import type { DownloadedArtifact } from './download';
+import { type PanePlatform } from './platform';
+export interface InstalledPane {
+    executablePath: string;
+    installKind: 'existing' | 'installed' | 'launched-installer';
+}
+export declare function resolveExistingPanePath(panePath?: string): string | undefined;
+export declare function shouldReuseExistingPane(parsed: Pick<ParsedArgs, 'command'>, target: InstallTarget): boolean;
+export declare function installPaneArtifact(artifact: DownloadedArtifact, options: {
+    parsed: ParsedArgs;
+    platform: PanePlatform;
+    format: Exclude<ArtifactFormat, 'auto'>;
+    target: InstallTarget;
+}): Promise<InstalledPane>;
+export declare function spawnPane(executablePath: string, args: string[]): Promise<number>;
+export declare function launchPaneClient(executablePath: string): void;
+//# sourceMappingURL=installers.d.ts.map

package/dist/installers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installers.d.ts","sourceRoot":"","sources":["../src/installers.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAEnE,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,UAAU,GAAG,WAAW,GAAG,oBAAoB,CAAC;CAC9D;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAiB7E;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAE3G;AAED,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,EAAE;IACP,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IACxC,MAAM,EAAE,aAAa,CAAC;CACvB,GACA,OAAO,CAAC,aAAa,CAAC,CAaxB;AAED,wBAAgB,SAAS,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAYjF;AAED,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAM7D"}

package/dist/installers.js

@@ -0,0 +1,122 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveExistingPanePath = resolveExistingPanePath;
+exports.shouldReuseExistingPane = shouldReuseExistingPane;
+exports.installPaneArtifact = installPaneArtifact;
+exports.spawnPane = spawnPane;
+exports.launchPaneClient = launchPaneClient;
+const child_process_1 = __importDefault(require("child_process"));
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const platform_1 = require("./platform");
+function resolveExistingPanePath(panePath) {
+    if (panePath) {
+        return fs_1.default.existsSync(panePath) ? panePath : undefined;
+    }
+    const candidates = [
+        process.platform === 'darwin' ? '/Applications/Pane.app/Contents/MacOS/Pane' : undefined,
+        process.platform === 'darwin' ? path_1.default.join(os_1.default.homedir(), 'Applications', 'Pane.app', 'Contents', 'MacOS', 'Pane') : undefined,
+        process.platform === 'linux' ? path_1.default.join(os_1.default.homedir(), '.local', 'bin', 'pane') : undefined,
+        process.platform === 'linux' ? '/usr/bin/pane' : undefined,
+        process.platform === 'linux' ? '/opt/Pane/pane' : undefined,
+        process.platform === 'win32' && process.env.LOCALAPPDATA ? path_1.default.join(process.env.LOCALAPPDATA, 'Programs', 'Pane', 'Pane.exe') : undefined,
+        process.platform === 'win32' && process.env.LOCALAPPDATA ? path_1.default.join(process.env.LOCALAPPDATA, 'Pane', 'Pane.exe') : undefined,
+        process.platform === 'win32' && process.env.ProgramFiles ? path_1.default.join(process.env.ProgramFiles, 'Pane', 'Pane.exe') : undefined
+    ].filter((candidate) => Boolean(candidate));
+    return candidates.find((candidate) => fs_1.default.existsSync(candidate));
+}
+function shouldReuseExistingPane(parsed, target) {
+    return parsed.command === 'install' && target === 'daemon';
+}
+async function installPaneArtifact(artifact, options) {
+    const existing = resolveExistingPanePath(options.parsed.panePath);
+    if (existing && shouldReuseExistingPane(options.parsed, options.target)) {
+        return { executablePath: existing, installKind: 'existing' };
+    }
+    if (options.platform.os === 'darwin') {
+        return installMac(artifact, options);
+    }
+    if (options.platform.os === 'linux') {
+        return installLinux(artifact, options);
+    }
+    return installWindows(artifact, options);
+}
+function spawnPane(executablePath, args) {
+    return new Promise((resolve) => {
+        const child = child_process_1.default.spawn(executablePath, args, {
+            stdio: 'inherit',
+            shell: false
+        });
+        child.on('close', (code) => resolve(code ?? 1));
+        child.on('error', (error) => {
+            console.error(`Failed to launch Pane: ${error.message}`);
+            resolve(1);
+        });
+    });
+}
+function launchPaneClient(executablePath) {
+    const child = child_process_1.default.spawn(executablePath, [], {
+        detached: true,
+        stdio: 'ignore'
+    });
+    child.unref();
+}
+function installMac(artifact, { format, target }) {
+    if (format === 'dmg') {
+        child_process_1.default.spawnSync('open', [artifact.path], { stdio: 'inherit' });
+        return { executablePath: '/Applications/Pane.app/Contents/MacOS/Pane', installKind: 'launched-installer' };
+    }
+    const appsRoot = path_1.default.join(os_1.default.homedir(), 'Applications');
+    const appPath = path_1.default.join(appsRoot, 'Pane.app');
+    fs_1.default.mkdirSync(appsRoot, { recursive: true });
+    child_process_1.default.execFileSync('ditto', ['-x', '-k', artifact.path, appsRoot], { stdio: 'inherit' });
+    const executablePath = path_1.default.join(appPath, 'Contents', 'MacOS', 'Pane');
+    if (!fs_1.default.existsSync(executablePath)) {
+        throw new Error(`Pane executable was not found after extracting ${artifact.fileName}. Expected ${executablePath}`);
+    }
+    if (target === 'client') {
+        child_process_1.default.spawnSync('open', [appPath], { stdio: 'inherit' });
+    }
+    return { executablePath, installKind: 'installed' };
+}
+function installLinux(artifact, { format }) {
+    if (format === 'deb') {
+        const installer = commandExists('apt') ? 'apt' : 'dpkg';
+        const args = installer === 'apt' ? ['install', '-y', artifact.path] : ['-i', artifact.path];
+        child_process_1.default.spawnSync('sudo', [installer, ...args], { stdio: 'inherit' });
+        const executablePath = resolveExistingPanePath();
+        if (!executablePath) {
+            throw new Error('Pane installed from .deb, but the pane executable could not be found.');
+        }
+        return { executablePath, installKind: 'installed' };
+    }
+    const binRoot = (0, platform_1.defaultInstallRoot)();
+    const executablePath = path_1.default.join(binRoot, 'pane');
+    fs_1.default.mkdirSync(binRoot, { recursive: true });
+    fs_1.default.copyFileSync(artifact.path, executablePath);
+    fs_1.default.chmodSync(executablePath, 0o755);
+    return { executablePath, installKind: 'installed' };
+}
+function installWindows(artifact, { target }) {
+    const args = target === 'daemon' ? ['/S'] : [];
+    const result = child_process_1.default.spawnSync(artifact.path, args, { stdio: 'inherit' });
+    if (result.error) {
+        throw result.error;
+    }
+    const executablePath = resolveExistingPanePath();
+    if (!executablePath) {
+        throw new Error('Pane installer completed, but Pane.exe could not be found. Open the installer manually and rerun with --pane-path.');
+    }
+    return { executablePath, installKind: target === 'daemon' ? 'installed' : 'launched-installer' };
+}
+function commandExists(command) {
+    const check = process.platform === 'win32' ? 'where' : 'command';
+    const args = process.platform === 'win32' ? [command] : ['-v', command];
+    const result = child_process_1.default.spawnSync(check, args, { stdio: 'ignore', shell: process.platform !== 'win32' });
+    return result.status === 0;
+}
+//# sourceMappingURL=installers.js.map

package/dist/installers.js.map

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

package/dist/platform.d.ts

@@ -0,0 +1,11 @@
+import type { ArtifactFormat } from './commands';
+export interface PanePlatform {
+    os: 'darwin' | 'linux' | 'win32';
+    arch: 'x64' | 'arm64';
+}
+export declare function detectPlatform(): PanePlatform;
+export declare function defaultFormat(platform: PanePlatform, target: 'client' | 'daemon'): Exclude<ArtifactFormat, 'auto'>;
+export declare function platformParam(platform: PanePlatform): 'mac' | 'linux' | 'windows';
+export declare function archAliases(platform: PanePlatform): string[];
+export declare function defaultInstallRoot(): string;
+//# sourceMappingURL=platform.d.ts.map

package/dist/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;IACjC,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC;CACvB;AAED,wBAAgB,cAAc,IAAI,YAAY,CAY7C;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC,CAQlH;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,GAAG,KAAK,GAAG,OAAO,GAAG,SAAS,CAIjF;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,EAAE,CAQ5D;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAY3C"}

package/dist/platform.js

@@ -0,0 +1,59 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectPlatform = detectPlatform;
+exports.defaultFormat = defaultFormat;
+exports.platformParam = platformParam;
+exports.archAliases = archAliases;
+exports.defaultInstallRoot = defaultInstallRoot;
+const os_1 = __importDefault(require("os"));
+function detectPlatform() {
+    const platform = process.platform;
+    const arch = process.arch;
+    if (platform !== 'darwin' && platform !== 'linux' && platform !== 'win32') {
+        throw new Error(`Unsupported OS: ${platform}`);
+    }
+    if (arch !== 'x64' && arch !== 'arm64') {
+        throw new Error(`Unsupported CPU architecture: ${arch}`);
+    }
+    return { os: platform, arch };
+}
+function defaultFormat(platform, target) {
+    if (platform.os === 'darwin') {
+        return target === 'daemon' ? 'zip' : 'dmg';
+    }
+    if (platform.os === 'win32') {
+        return 'exe';
+    }
+    return 'appimage';
+}
+function platformParam(platform) {
+    if (platform.os === 'darwin')
+        return 'mac';
+    if (platform.os === 'win32')
+        return 'windows';
+    return 'linux';
+}
+function archAliases(platform) {
+    if (platform.arch === 'arm64') {
+        return ['arm64', 'aarch64'];
+    }
+    if (platform.os === 'linux') {
+        return ['x64', 'x86_64', 'amd64'];
+    }
+    return ['x64', 'x86_64'];
+}
+function defaultInstallRoot() {
+    if (process.platform === 'win32') {
+        return process.env.LOCALAPPDATA
+            ? `${process.env.LOCALAPPDATA}\\Pane`
+            : `${os_1.default.homedir()}\\AppData\\Local\\Pane`;
+    }
+    if (process.platform === 'darwin') {
+        return `${os_1.default.homedir()}/Applications`;
+    }
+    return `${os_1.default.homedir()}/.local/bin`;
+}
+//# sourceMappingURL=platform.js.map

package/dist/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":";;;;;AAQA,wCAYC;AAED,sCAQC;AAED,sCAIC;AAED,kCAQC;AAED,gDAYC;AA5DD,4CAAoB;AAQpB,SAAgB,cAAc;IAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAE1B,IAAI,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC1E,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAChC,CAAC;AAED,SAAgB,aAAa,CAAC,QAAsB,EAAE,MAA2B;IAC/E,IAAI,QAAQ,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IAC7C,CAAC;IACD,IAAI,QAAQ,CAAC,EAAE,KAAK,OAAO,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAgB,aAAa,CAAC,QAAsB;IAClD,IAAI,QAAQ,CAAC,EAAE,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC3C,IAAI,QAAQ,CAAC,EAAE,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC;IAC9C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAgB,WAAW,CAAC,QAAsB;IAChD,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC9B,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,QAAQ,CAAC,EAAE,KAAK,OAAO,EAAE,CAAC;QAC5B,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AAC3B,CAAC;AAED,SAAgB,kBAAkB;IAChC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY;YAC7B,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,QAAQ;YACrC,CAAC,CAAC,GAAG,YAAE,CAAC,OAAO,EAAE,wBAAwB,CAAC;IAC9C,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,GAAG,YAAE,CAAC,OAAO,EAAE,eAAe,CAAC;IACxC,CAAC;IAED,OAAO,GAAG,YAAE,CAAC,OAAO,EAAE,aAAa,CAAC;AACtC,CAAC"}

package/dist/releases.d.ts

@@ -0,0 +1,37 @@
+import type { ArtifactFormat } from './commands';
+import { type PanePlatform } from './platform';
+export interface GitHubReleaseAsset {
+    name: string;
+    browser_download_url: string;
+}
+export interface GitHubRelease {
+    tag_name: string;
+    name: string;
+    body: string;
+    html_url: string;
+    published_at: string;
+    prerelease: boolean;
+    draft: boolean;
+    assets?: GitHubReleaseAsset[];
+}
+export interface ResolvedRelease {
+    release: GitHubRelease;
+    artifact: GitHubReleaseAsset;
+    format: Exclude<ArtifactFormat, 'auto'>;
+    preferredDownloadUrl: string;
+    fallbackDownloadUrl: string;
+    checksumUrl: string;
+}
+export interface ResolveReleaseOptions {
+    version: string;
+    channel: 'stable' | 'nightly';
+    source: 'npm' | 'pip';
+    platform: PanePlatform;
+    format: ArtifactFormat;
+    target: 'client' | 'daemon';
+}
+export declare function resolveRelease(options: ResolveReleaseOptions): Promise<ResolvedRelease>;
+export declare function fetchRelease(version: string): Promise<GitHubRelease>;
+export declare function findArtifact(release: GitHubRelease, platform: PanePlatform, format: Exclude<ArtifactFormat, 'auto'>): GitHubReleaseAsset;
+export declare function artifactFileName(urlOrName: string): string;
+//# sourceMappingURL=releases.d.ts.map

package/dist/releases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"releases.d.ts","sourceRoot":"","sources":["../src/releases.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAA6C,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAK1F,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,MAAM,EAAE,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IACxC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC9B,MAAM,EAAE,KAAK,GAAG,KAAK,CAAC;IACtB,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC7B;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CAc7F;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAkB1E;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC,GACtC,kBAAkB,CAcpB;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE1D"}

package/dist/releases.js

@@ -0,0 +1,89 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveRelease = resolveRelease;
+exports.fetchRelease = fetchRelease;
+exports.findArtifact = findArtifact;
+exports.artifactFileName = artifactFileName;
+const path_1 = __importDefault(require("path"));
+const platform_1 = require("./platform");
+const GITHUB_API_BASE = 'https://api.github.com/repos/dcouple/Pane/releases';
+const DOWNLOAD_API_BASE = 'https://runpane.com/api/download';
+async function resolveRelease(options) {
+    const release = await fetchRelease(options.version);
+    const format = options.format === 'auto' ? (0, platform_1.defaultFormat)(options.platform, options.target) : options.format;
+    const artifact = findArtifact(release, options.platform, format);
+    const preferredDownloadUrl = buildPreferredDownloadUrl(options, format, release);
+    return {
+        release,
+        artifact,
+        format,
+        preferredDownloadUrl,
+        fallbackDownloadUrl: artifact.browser_download_url,
+        checksumUrl: `https://github.com/dcouple/Pane/releases/download/${release.tag_name}/SHA256SUMS.txt`
+    };
+}
+async function fetchRelease(version) {
+    const normalized = version === 'latest' ? 'latest' : version.startsWith('v') ? `tags/${version}` : `tags/v${version}`;
+    const response = await fetch(`${GITHUB_API_BASE}/${normalized}`, {
+        headers: {
+            accept: 'application/vnd.github+json',
+            'user-agent': 'runpane-installer'
+        }
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to fetch Pane release ${version}: ${response.status} ${response.statusText}`);
+    }
+    const release = await response.json();
+    if (release.draft || release.prerelease) {
+        throw new Error(`Release ${release.tag_name} is not a stable public release.`);
+    }
+    return release;
+}
+function findArtifact(release, platform, format) {
+    const assets = release.assets ?? [];
+    const aliases = (0, platform_1.archAliases)(platform);
+    const candidates = assets.filter((asset) => matchesFormat(asset.name, format) && matchesPlatform(asset.name, platform));
+    const exact = candidates.find((asset) => aliases.some((alias) => lowerName(asset).includes(alias.toLowerCase())));
+    const universal = candidates.find((asset) => lowerName(asset).includes('universal'));
+    const selected = exact ?? universal ?? candidates[0];
+    if (!selected) {
+        const assetNames = assets.map((asset) => asset.name).join(', ') || 'no assets';
+        throw new Error(`No Pane ${format} asset found for ${platform.os}/${platform.arch} in ${release.tag_name}. Assets: ${assetNames}`);
+    }
+    return selected;
+}
+function artifactFileName(urlOrName) {
+    return path_1.default.basename(urlOrName.split('?')[0]);
+}
+function buildPreferredDownloadUrl(options, format, release) {
+    const params = new URLSearchParams({
+        platform: (0, platform_1.platformParam)(options.platform),
+        arch: options.platform.arch,
+        format,
+        version: release.tag_name,
+        channel: options.channel,
+        source: options.source
+    });
+    return `${DOWNLOAD_API_BASE}?${params.toString()}`;
+}
+function matchesFormat(name, format) {
+    const lower = name.toLowerCase();
+    if (format === 'appimage')
+        return lower.endsWith('.appimage');
+    return lower.endsWith(`.${format}`);
+}
+function matchesPlatform(name, platform) {
+    const lower = name.toLowerCase();
+    if (platform.os === 'darwin')
+        return lower.includes('macos') || lower.includes('darwin') || lower.includes('mac');
+    if (platform.os === 'win32')
+        return lower.includes('windows') || /(?:^|[._-])win(?:32|64)?(?:[._-]|$)/.test(lower);
+    return lower.includes('linux');
+}
+function lowerName(asset) {
+    return asset.name.toLowerCase();
+}
+//# sourceMappingURL=releases.js.map

package/dist/releases.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,4 @@
+export declare function getWrapperVersion(): string;
+export declare function printVersion(panePath?: string): Promise<number>;
+export declare function getPaneVersion(executablePath: string): string | undefined;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAMA,wBAAgB,iBAAiB,IAAI,MAAM,CAQ1C;AAED,wBAAsB,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBrE;AAED,wBAAgB,cAAc,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWzE"}

package/dist/version.js

@@ -0,0 +1,59 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getWrapperVersion = getWrapperVersion;
+exports.printVersion = printVersion;
+exports.getPaneVersion = getPaneVersion;
+const child_process_1 = __importDefault(require("child_process"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const releases_1 = require("./releases");
+const installers_1 = require("./installers");
+function getWrapperVersion() {
+    const packagePath = path_1.default.resolve(__dirname, '..', 'package.json');
+    try {
+        const pkg = JSON.parse(fs_1.default.readFileSync(packagePath, 'utf8'));
+        return pkg.version ?? 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+async function printVersion(panePath) {
+    const wrapperVersion = getWrapperVersion();
+    const installedPath = (0, installers_1.resolveExistingPanePath)(panePath);
+    const installedVersion = installedPath ? getPaneVersion(installedPath) : undefined;
+    let latest = 'unavailable';
+    try {
+        latest = normalizeVersion((await (0, releases_1.fetchRelease)('latest')).tag_name);
+    }
+    catch {
+        // Keep version output useful when offline.
+    }
+    console.log(`runpane ${wrapperVersion}`);
+    console.log(`Pane installed: ${installedVersion ?? 'not found'}`);
+    console.log(`Pane latest: ${latest}`);
+    if (installedPath) {
+        console.log(`Pane path: ${installedPath}`);
+    }
+    return 0;
+}
+function getPaneVersion(executablePath) {
+    try {
+        const result = child_process_1.default.spawnSync(executablePath, ['--version'], {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'pipe']
+        });
+        const output = `${result.stdout ?? ''}${result.stderr ?? ''}`.trim();
+        return output || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function normalizeVersion(version) {
+    return version.replace(/^v/, '');
+}
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":";;;;;AAMA,8CAQC;AAED,oCAmBC;AAED,wCAWC;AAhDD,kEAAyC;AACzC,4CAAoB;AACpB,gDAAwB;AACxB,yCAA0C;AAC1C,6CAAuD;AAEvD,SAAgB,iBAAiB;IAC/B,MAAM,WAAW,GAAG,cAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;IAClE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAE,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAyB,CAAC;QACrF,OAAO,GAAG,CAAC,OAAO,IAAI,SAAS,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,YAAY,CAAC,QAAiB;IAClD,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;IAC3C,MAAM,aAAa,GAAG,IAAA,oCAAuB,EAAC,QAAQ,CAAC,CAAC;IACxD,MAAM,gBAAgB,GAAG,aAAa,CAAC,CAAC,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACnF,IAAI,MAAM,GAAG,aAAa,CAAC;IAE3B,IAAI,CAAC;QACH,MAAM,GAAG,gBAAgB,CAAC,CAAC,MAAM,IAAA,uBAAY,EAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,2CAA2C;IAC7C,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,WAAW,cAAc,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,mBAAmB,gBAAgB,IAAI,WAAW,EAAE,CAAC,CAAC;IAClE,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,EAAE,CAAC,CAAC;IACtC,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,cAAc,aAAa,EAAE,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAgB,cAAc,CAAC,cAAsB;IACnD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,uBAAY,CAAC,SAAS,CAAC,cAAc,EAAE,CAAC,WAAW,CAAC,EAAE;YACnE,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;QACrE,OAAO,MAAM,IAAI,SAAS,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAe;IACvC,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AACnC,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "runpane",
+  "version": "2.2.9",
+  "description": "Thin npm installer and remote setup CLI for Pane",
+  "license": "AGPL-3.0",
+  "homepage": "https://runpane.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dcouple/Pane.git",
+    "directory": "packages/runpane"
+  },
+  "bugs": {
+    "url": "https://github.com/dcouple/Pane/issues"
+  },
+  "bin": {
+    "runpane": "dist/cli.js"
+  },
+  "main": "dist/cli.js",
+  "types": "dist/cli.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc && node scripts/mark-executable.js",
+    "lint": "eslint src --ext .ts",
+    "typecheck": "tsc --noEmit",
+    "prepack": "pnpm run build"
+  },
+  "engines": {
+    "node": ">=18.17.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.17.0",
+    "@types/node": "^22.10.2",
+    "@typescript-eslint/eslint-plugin": "^8.19.0",
+    "@typescript-eslint/parser": "^8.19.0",
+    "eslint": "^9.17.0",
+    "typescript": "^5.7.2",
+    "typescript-eslint": "^8.19.0"
+  }
+}