@peerbit/shared-fs-cli 0.0.1

package/lib/esm/native-adapter.d.ts

@@ -0,0 +1,55 @@
+export type NativeAdapterTarget = {
+    id: string;
+    platform: NodeJS.Platform;
+    arch: NodeJS.Architecture;
+    archiveExtension: "tar.gz" | "zip";
+    binaryName: string;
+};
+export type ResolveNativeAdapterOptions = {
+    env?: NodeJS.ProcessEnv;
+    installDir?: string;
+    platform?: NodeJS.Platform;
+    commandExists?: (command: string) => Promise<boolean>;
+};
+export type InstallNativeAdapterOptions = {
+    installDir?: string;
+    platform?: NodeJS.Platform;
+    arch?: NodeJS.Architecture;
+    version?: string;
+    baseUrl?: string;
+    force?: boolean;
+    ifNeeded?: boolean;
+};
+export type InstallNativeAdapterResult = {
+    binaryPath: string;
+    installed: boolean;
+    skippedReason?: "already-installed";
+    target: NativeAdapterTarget;
+    assetName: string;
+    url: string;
+};
+export declare class NativeAdapterInstallError extends Error {
+    constructor(message: string);
+}
+export declare const nativeAdapterBinaryName: (platform?: NodeJS.Platform) => "peerbit-shared-fs-native" | "peerbit-shared-fs-native.exe";
+export declare const getNativeAdapterTarget: (platform?: NodeJS.Platform, arch?: NodeJS.Architecture) => NativeAdapterTarget;
+export declare const nativeAdapterAssetName: (target: NativeAdapterTarget) => string;
+export declare const nativeAdapterReleaseTag: (version: string) => string;
+export declare const nativeAdapterDownloadBaseUrl: (tag: string) => string;
+export declare const nativeAdapterDownloadUrl: (options: {
+    assetName: string;
+    baseUrl?: string;
+    tag: string;
+}) => string;
+export declare const defaultNativeAdapterInstallDir: (env?: NodeJS.ProcessEnv) => string;
+export declare const defaultNativeAdapterPath: (options?: {
+    env?: NodeJS.ProcessEnv;
+    installDir?: string;
+    platform?: NodeJS.Platform;
+}) => string;
+export declare const commandExistsOnPath: (command: string, options?: {
+    env?: NodeJS.ProcessEnv;
+    platform?: NodeJS.Platform;
+}) => Promise<boolean>;
+export declare const resolveExternalNativeAdapter: (explicitCommand?: string, options?: ResolveNativeAdapterOptions) => Promise<string | undefined>;
+export declare const installNativeAdapter: (options?: InstallNativeAdapterOptions) => Promise<InstallNativeAdapterResult>;

package/lib/esm/native-adapter.js

@@ -0,0 +1,268 @@
+import { spawn } from "node:child_process";
+import fs from "node:fs";
+import fsp from "node:fs/promises";
+import http from "node:http";
+import https from "node:https";
+import os from "node:os";
+import path from "node:path";
+import { pipeline } from "node:stream/promises";
+import { fileURLToPath } from "node:url";
+const CLI_PACKAGE_NAME = "@peerbit/shared-fs-cli";
+const DEFAULT_RELEASE_REPOSITORY = "dao-xyz/peerbit-examples";
+const DEFAULT_PATH_COMMAND = "peerbit-shared-fs-native";
+export class NativeAdapterInstallError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "NativeAdapterInstallError";
+    }
+}
+export const nativeAdapterBinaryName = (platform = process.platform) => platform === "win32" ? `${DEFAULT_PATH_COMMAND}.exe` : DEFAULT_PATH_COMMAND;
+export const getNativeAdapterTarget = (platform = process.platform, arch = process.arch) => {
+    if (platform !== "linux" && platform !== "darwin" && platform !== "win32") {
+        throw new NativeAdapterInstallError(`No prebuilt native adapter target for platform ${platform}.`);
+    }
+    if (arch !== "x64" && arch !== "arm64") {
+        throw new NativeAdapterInstallError(`No prebuilt native adapter target for architecture ${arch}.`);
+    }
+    return {
+        id: `${platform}-${arch}`,
+        platform,
+        arch,
+        archiveExtension: platform === "win32" ? "zip" : "tar.gz",
+        binaryName: nativeAdapterBinaryName(platform),
+    };
+};
+export const nativeAdapterAssetName = (target) => `peerbit-shared-fs-native-${target.id}.${target.archiveExtension}`;
+export const nativeAdapterReleaseTag = (version) => version.startsWith("shared-fs-native-v")
+    ? version
+    : `shared-fs-native-v${version.replace(/^v/, "")}`;
+export const nativeAdapterDownloadBaseUrl = (tag) => `https://github.com/${DEFAULT_RELEASE_REPOSITORY}/releases/download/${tag}`;
+export const nativeAdapterDownloadUrl = (options) => {
+    const baseUrl = options.baseUrl ?? nativeAdapterDownloadBaseUrl(options.tag);
+    return `${baseUrl.replace(/\/$/, "")}/${options.assetName}`;
+};
+export const defaultNativeAdapterInstallDir = (env = process.env) => env.PEERBIT_SHARED_FS_NATIVE_INSTALL_DIR ||
+    path.join(os.homedir(), ".peerbit", "shared-fs", "bin");
+export const defaultNativeAdapterPath = (options = {}) => path.join(options.installDir ??
+    defaultNativeAdapterInstallDir(options.env ?? process.env), nativeAdapterBinaryName(options.platform ?? process.platform));
+const pathExists = async (candidate) => {
+    try {
+        await fsp.access(candidate, fs.constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const executablePathExists = async (candidate) => {
+    try {
+        await fsp.access(candidate, fs.constants.X_OK);
+        return true;
+    }
+    catch {
+        return process.platform === "win32" && (await pathExists(candidate));
+    }
+};
+const isPathLikeCommand = (command) => path.isAbsolute(command) || command.includes("/") || command.includes("\\");
+export const commandExistsOnPath = async (command, options = {}) => {
+    const env = options.env ?? process.env;
+    const platform = options.platform ?? process.platform;
+    if (isPathLikeCommand(command)) {
+        return executablePathExists(command);
+    }
+    const pathValue = env.PATH;
+    if (!pathValue) {
+        return false;
+    }
+    const extensions = platform === "win32"
+        ? (env.PATHEXT ?? ".EXE;.CMD;.BAT;.COM").split(";").filter(Boolean)
+        : [""];
+    const commandNames = platform === "win32" && path.extname(command) === ""
+        ? [
+            command,
+            ...extensions.map((extension) => `${command}${extension}`),
+        ]
+        : [command];
+    for (const directory of pathValue.split(path.delimiter)) {
+        for (const commandName of commandNames) {
+            if (await executablePathExists(path.join(directory, commandName))) {
+                return true;
+            }
+        }
+    }
+    return false;
+};
+export const resolveExternalNativeAdapter = async (explicitCommand, options = {}) => {
+    const env = options.env ?? process.env;
+    const platform = options.platform ?? process.platform;
+    const commandExists = options.commandExists ??
+        ((command) => commandExistsOnPath(command, { env, platform }));
+    if (explicitCommand?.trim()) {
+        return explicitCommand;
+    }
+    if (env.PEERBIT_SHARED_FS_NATIVE_ADAPTER?.trim()) {
+        return env.PEERBIT_SHARED_FS_NATIVE_ADAPTER;
+    }
+    const managedPath = defaultNativeAdapterPath({
+        env,
+        installDir: options.installDir,
+        platform,
+    });
+    if (await pathExists(managedPath)) {
+        return managedPath;
+    }
+    if (await commandExists(DEFAULT_PATH_COMMAND)) {
+        return DEFAULT_PATH_COMMAND;
+    }
+    return undefined;
+};
+const readCliPackageVersion = async () => {
+    let directory = path.dirname(fileURLToPath(import.meta.url));
+    while (true) {
+        const packagePath = path.join(directory, "package.json");
+        try {
+            const parsed = JSON.parse(await fsp.readFile(packagePath, "utf8"));
+            if (parsed.name === CLI_PACKAGE_NAME && parsed.version) {
+                return parsed.version;
+            }
+        }
+        catch { }
+        const parent = path.dirname(directory);
+        if (parent === directory) {
+            throw new NativeAdapterInstallError(`Unable to find ${CLI_PACKAGE_NAME} package version.`);
+        }
+        directory = parent;
+    }
+};
+const downloadFile = async (url, destination, redirectBudget = 5) => {
+    const parsedUrl = new URL(url);
+    const client = parsedUrl.protocol === "http:" ? http : https;
+    await new Promise((resolve, reject) => {
+        const request = client.get(parsedUrl, {
+            headers: {
+                "user-agent": `${CLI_PACKAGE_NAME} native-adapter-installer`,
+            },
+        }, (response) => {
+            const statusCode = response.statusCode ?? 0;
+            const location = response.headers.location;
+            if (statusCode >= 300 &&
+                statusCode < 400 &&
+                location &&
+                redirectBudget > 0) {
+                response.resume();
+                downloadFile(new URL(location, parsedUrl).toString(), destination, redirectBudget - 1).then(resolve, reject);
+                return;
+            }
+            if (statusCode !== 200) {
+                response.resume();
+                reject(new NativeAdapterInstallError(`Download failed with HTTP ${statusCode}: ${url}`));
+                return;
+            }
+            pipeline(response, fs.createWriteStream(destination)).then(resolve, reject);
+        });
+        request.on("error", reject);
+    });
+};
+const runProcess = async (command, args) => {
+    await new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            stdio: ["ignore", "ignore", "pipe"],
+        });
+        let stderr = "";
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk.toString("utf8");
+        });
+        child.once("error", reject);
+        child.once("exit", (code, signal) => {
+            if (code === 0) {
+                resolve();
+                return;
+            }
+            reject(new NativeAdapterInstallError(`${command} ${args.join(" ")} failed with code=${code} signal=${signal}: ${stderr.trim()}`));
+        });
+    });
+};
+const extractArchive = async (archivePath, outputDirectory, target) => {
+    if (target.archiveExtension === "zip") {
+        const quotePowerShell = (value) => `'${value.replace(/'/g, "''")}'`;
+        await runProcess("powershell.exe", [
+            "-NoProfile",
+            "-ExecutionPolicy",
+            "Bypass",
+            "-Command",
+            `Expand-Archive -LiteralPath ${quotePowerShell(archivePath)} -DestinationPath ${quotePowerShell(outputDirectory)} -Force`,
+        ]);
+        return;
+    }
+    await runProcess("tar", ["-xzf", archivePath, "-C", outputDirectory]);
+};
+const findExtractedBinary = async (directory, binaryName) => {
+    const entries = await fsp.readdir(directory, { withFileTypes: true });
+    for (const entry of entries) {
+        const entryPath = path.join(directory, entry.name);
+        if (entry.isFile() &&
+            entry.name.toLowerCase() === binaryName.toLowerCase()) {
+            return entryPath;
+        }
+        if (entry.isDirectory()) {
+            const found = await findExtractedBinary(entryPath, binaryName);
+            if (found) {
+                return found;
+            }
+        }
+    }
+    return undefined;
+};
+export const installNativeAdapter = async (options = {}) => {
+    const target = getNativeAdapterTarget(options.platform, options.arch);
+    const installDir = options.installDir ?? defaultNativeAdapterInstallDir(process.env);
+    const binaryPath = path.join(installDir, target.binaryName);
+    const existing = await pathExists(binaryPath);
+    const version = options.version ??
+        process.env.PEERBIT_SHARED_FS_NATIVE_VERSION ??
+        (await readCliPackageVersion());
+    const tag = nativeAdapterReleaseTag(version);
+    const assetName = nativeAdapterAssetName(target);
+    const url = nativeAdapterDownloadUrl({
+        assetName,
+        baseUrl: options.baseUrl ??
+            process.env.PEERBIT_SHARED_FS_NATIVE_RELEASE_BASE_URL,
+        tag,
+    });
+    if (existing && (options.ifNeeded || !options.force)) {
+        return {
+            binaryPath,
+            installed: false,
+            skippedReason: "already-installed",
+            target,
+            assetName,
+            url,
+        };
+    }
+    const tempDirectory = await fsp.mkdtemp(path.join(os.tmpdir(), "peerbit-shared-fs-native-"));
+    try {
+        const archivePath = path.join(tempDirectory, assetName);
+        await downloadFile(url, archivePath);
+        await extractArchive(archivePath, tempDirectory, target);
+        const extractedBinary = await findExtractedBinary(tempDirectory, target.binaryName);
+        if (!extractedBinary) {
+            throw new NativeAdapterInstallError(`Archive ${assetName} did not contain ${target.binaryName}.`);
+        }
+        await fsp.mkdir(installDir, { recursive: true });
+        await fsp.copyFile(extractedBinary, binaryPath);
+        if (target.platform !== "win32") {
+            await fsp.chmod(binaryPath, 0o755);
+        }
+        return {
+            binaryPath,
+            installed: true,
+            target,
+            assetName,
+            url,
+        };
+    }
+    finally {
+        await fsp.rm(tempDirectory, { recursive: true, force: true });
+    }
+};
+//# sourceMappingURL=native-adapter.js.map

package/lib/esm/native-adapter.js.map

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

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@peerbit/shared-fs-cli",
+  "version": "0.0.1",
+  "author": "dao.xyz",
+  "repository": "https://github.com/dao-xyz/peerbit-examples",
+  "license": "Apache-2.0",
+  "type": "module",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "module": "lib/esm/index.js",
+  "types": "lib/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/esm/index.d.ts",
+      "import": "./lib/esm/index.js"
+    }
+  },
+  "bin": {
+    "peerbit-fs": "./lib/esm/bin.js"
+  },
+  "files": [
+    "lib",
+    "src",
+    "scripts",
+    "!src/**/__tests__",
+    "!lib/**/__tests__",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@multiformats/multiaddr": "^13.0.1",
+    "chalk": "^5.3.0",
+    "peerbit": "^5.2.19",
+    "yargs": "^17.7.2",
+    "@peerbit/shared-fs": "0.0.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.3"
+  },
+  "scripts": {
+    "clean": "shx rm -rf lib/*",
+    "build": "pnpm run clean && tsc -p tsconfig.json",
+    "install-native-adapter": "node lib/esm/install-native-adapter.js",
+    "postinstall": "node scripts/postinstall.mjs",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}

package/scripts/postinstall.mjs

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { spawnSync } from "node:child_process";
+
+if (process.env.PEERBIT_SHARED_FS_SKIP_NATIVE_POSTINSTALL === "1") {
+    process.exit(0);
+}
+
+const isGlobalInstall =
+    process.env.npm_config_global === "true" ||
+    process.env.npm_config_global === "1" ||
+    process.env.npm_config_location === "global";
+
+if (!isGlobalInstall) {
+    process.exit(0);
+}
+
+const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)));
+const installer = join(packageRoot, "lib", "esm", "install-native-adapter.js");
+
+if (!existsSync(installer)) {
+    process.exit(0);
+}
+
+const result = spawnSync(
+    process.execPath,
+    [installer, "--if-needed", "--quiet"],
+    { stdio: "inherit" }
+);
+
+if (result.error || result.status !== 0) {
+    console.warn(
+        "peerbit-fs native adapter auto-install skipped; run `peerbit-fs install-adapter` after install."
+    );
+}

package/src/bin.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+
+import { runCli } from "./index.js";
+
+runCli().catch((error) => {
+    console.error(error instanceof Error ? error.message : error);
+    process.exitCode = 1;
+});

package/src/cross-os-interop.ts

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { openSharedFs } from "@peerbit/shared-fs";
+import { Peerbit } from "peerbit";
+
+type Options = {
+    role: "seed" | "join";
+    machine: string;
+    expected: string[];
+    addressFile: string;
+    timeoutMs: number;
+    directory?: string;
+};
+
+const parseArgs = (args: string[]): Options => {
+    const value = (name: string) => {
+        const index = args.indexOf(name);
+        return index === -1 ? undefined : args[index + 1];
+    };
+    const role = value("--role");
+    if (role !== "seed" && role !== "join") {
+        throw new Error("--role must be seed or join");
+    }
+    const machine = value("--machine");
+    if (!machine) {
+        throw new Error("--machine is required");
+    }
+    const addressFile = value("--address-file");
+    if (!addressFile) {
+        throw new Error("--address-file is required");
+    }
+    return {
+        role,
+        machine,
+        expected: (value("--expected") ?? "linux,macos,windows")
+            .split(",")
+            .map((entry) => entry.trim())
+            .filter(Boolean),
+        addressFile,
+        timeoutMs: Number(value("--timeout-ms") ?? 10 * 60 * 1000),
+        directory: value("--directory"),
+    };
+};
+
+const decode = (value: Uint8Array | undefined) =>
+    value ? new TextDecoder().decode(value) : undefined;
+
+const waitUntil = async (
+    assertion: () => Promise<void> | void,
+    timeoutMs: number,
+    intervalMs = 2_000
+) => {
+    const deadline = Date.now() + timeoutMs;
+    let lastError: unknown;
+    while (Date.now() < deadline) {
+        try {
+            await assertion();
+            return;
+        } catch (error) {
+            lastError = error;
+            await new Promise((resolve) => setTimeout(resolve, intervalMs));
+        }
+    }
+    throw lastError;
+};
+
+const filePathForMachine = (machine: string) => `/${machine}.txt`;
+
+const waitForAllMachines = async (
+    fs: Awaited<ReturnType<typeof openSharedFs>>,
+    expected: string[],
+    timeoutMs: number
+) => {
+    await waitUntil(async () => {
+        const missing: string[] = [];
+        for (const machine of expected) {
+            const contents = decode(
+                await fs.readFile(filePathForMachine(machine))
+            );
+            if (contents !== `hello from ${machine}`) {
+                missing.push(machine);
+            }
+        }
+        if (missing.length > 0) {
+            throw new Error(`Missing files from: ${missing.join(", ")}`);
+        }
+    }, timeoutMs);
+};
+
+const main = async () => {
+    const options = parseArgs(process.argv.slice(2));
+    const peer = await Peerbit.create({ directory: options.directory });
+    try {
+        await peer.bootstrap();
+        const address =
+            options.role === "join"
+                ? (await readFile(options.addressFile, "utf8")).trim()
+                : undefined;
+        const fs = await openSharedFs({
+            peerbit: peer,
+            address,
+            machineLabel: options.machine,
+        });
+
+        if (options.role === "seed") {
+            await mkdir(path.dirname(options.addressFile), { recursive: true });
+            await writeFile(options.addressFile, fs.address ?? "", "utf8");
+            console.log(`seed address: ${fs.address}`);
+        } else {
+            console.log(`joining address: ${address}`);
+        }
+
+        await fs.writeFile(
+            filePathForMachine(options.machine),
+            `hello from ${options.machine}`
+        );
+        await waitForAllMachines(fs, options.expected, options.timeoutMs);
+        console.log(
+            `read files from all machines: ${options.expected.join(", ")}`
+        );
+    } finally {
+        await peer.stop();
+    }
+};
+
+main().catch((error) => {
+    console.error(
+        error instanceof Error ? error.stack || error.message : error
+    );
+    process.exitCode = 1;
+});