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

``bash
npm i x-launcher-kit
`

Quick use

`js
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

`bash
npm ci
npm test
npm run lint
npm run format
``