x-launcher-kit (JS)

A practical Node.js toolkit that bundles:

• fs: filesystem helpers (JSON/text, ensureDir, glob, watch, copy/remove, sha256)
• os: OS info + safe-ish exec() wrapper
• net: HTTP (fetch), TCP connect, DNS resolve
• vpn: provider abstraction with best-effort native providers
  • Windows: rasdial
  • macOS: scutil --nc
  • Linux: nmcli (NetworkManager)
• zip: zip/unzip utilities (streaming)
• builders: scaffold generators (app/gui/database)

No TypeScript. Just JavaScript + JSDoc.

Install

npm i x-launcher-kit

Quick use

import { fsx, osx, netx, vpnx, zipx, builders } from "x-launcher-kit";

await fsx.ensureDir("./out");
await fsx.writeJson("./out/config.json", { ok: true });

const info = await osx.exec("node", ["-v"]);
console.log(info.stdout.trim());

const res = await netx.httpGet("https://example.com");
console.log(res.status);

await zipx.zipDir("./out", "./out.zip");
await zipx.unzipTo("./out.zip", "./unzipped");

const app = new builders.AppBuilder({ name: "demo-app" });
await app.writeTo("./scaffolds/demo-app");

VPN notes

VPN control is OS-dependent and may require admin permissions. This package provides a consistent API, but parsing/behavior varies by OS tools.

• Windows: relies on rasdial
• macOS: relies on scutil --nc
• Linux: relies on nmcli

If the tool isn't available, the provider will throw a helpful error.

Development

npm ci
npm test
npm run lint
npm run format