nxcode-ide 1.0.0

package/README.md

@@ -0,0 +1,161 @@
+# NxCode IDE
+
+Downloader resmi **NxCode Desktop IDE** untuk Windows.
+
+NxCode menyatukan project explorer, editor multi-tab, terminal PowerShell,
+Chat AI, dan Database Manager dalam satu aplikasi desktop.
+
+![Tampilan NxCode IDE](https://unpkg.com/nxcode-ide@latest/screenshot/a1.png)
+
+## Perbedaan versi
+
+Paket npm dan aplikasi IDE memiliki siklus versi yang berbeda:
+
+- `nxcode-ide@1.0.0` adalah versi downloader npm.
+- Versi NxCode IDE terbaru dibaca dari
+  [nxdom.org/download.json](https://nxdom.org/download.json).
+- Saat ini distribusi resmi menyediakan NxCode IDE `1.0.5`.
+
+Karena metadata dibaca secara dinamis, downloader tidak perlu diperbarui setiap
+kali versi IDE baru diterbitkan.
+
+## Persyaratan
+
+- Windows 10/11 64-bit untuk menjalankan installer
+- Node.js 18 atau lebih baru untuk memakai downloader npm
+- Koneksi internet
+- Ruang kosong untuk installer sekitar 189 MB dan aplikasi yang dipasang
+
+## Instalasi downloader
+
+```bash
+npm install --global nxcode-ide
+nxcode-ide --help
+```
+
+Tanpa instalasi global:
+
+```bash
+npx nxcode-ide info
+npx nxcode-ide install
+```
+
+Instalasi paket npm tidak otomatis mengunduh atau menjalankan EXE.
+
+## Menginstal NxCode IDE
+
+```bash
+nxcode-ide install
+```
+
+Alurnya:
+
+1. Mengambil versi dan URL resmi dari `https://nxdom.org/download.json`.
+2. Mencocokkan asset dengan GitHub Release.
+3. Meminta persetujuan sebelum mengunduh installer.
+4. Menampilkan progres download.
+5. Memeriksa ukuran dan SHA-256 dari GitHub Releases API.
+6. Meminta persetujuan sebelum membuka installer.
+
+Untuk otomasi non-interaktif:
+
+```bash
+nxcode-ide install --yes
+```
+
+`--yes` menyetujui download dan pembukaan installer. Gunakan hanya pada
+lingkungan yang Anda kendalikan.
+
+## Download tanpa menjalankan installer
+
+Simpan installer di direktori aktif:
+
+```bash
+nxcode-ide download --yes
+```
+
+Tentukan lokasi sendiri:
+
+```bash
+nxcode-ide download --output "D:\Downloads\NxCode-Setup.exe" --yes
+```
+
+Command `download` tidak pernah membuka installer. Mode ini juga dapat dipakai
+untuk mengambil installer dari sistem non-Windows.
+
+## Melihat informasi rilis
+
+```bash
+nxcode-ide info
+nxcode-ide info --json
+```
+
+Informasi meliputi versi IDE, platform, ukuran, SHA-256, halaman release, dan
+URL installer.
+
+## Keamanan distribusi
+
+- Hanya URL HTTPS dari asset `github.com/.../releases/download/...` yang diterima.
+- Nama asset harus berupa file `.exe` yang aman.
+- Asset harus tercatat pada GitHub Release yang sesuai.
+- Ukuran file dan digest SHA-256 harus cocok sebelum installer dapat dijalankan.
+- File parsial dibersihkan jika download atau verifikasi gagal.
+- EXE tidak dibundel ke tarball npm; installer tetap berasal dari GitHub Release resmi.
+
+Untuk NxCode IDE `1.0.5`, asset resminya adalah
+`Nx-Code-Setup-1.0.5.exe` dengan SHA-256:
+
+```text
+6665009acd430a8e4bf80ab8cbd9666879c25a50a291eb0bbc033cb78cc9c04f
+```
+
+## Download manual
+
+Versi terbaru dan tombol download tersedia di:
+
+- [NxCode pada nxdom.org](https://nxdom.org/#nxcode)
+- [GitHub Release NxCode](https://github.com/Nxadom/software/releases/latest)
+
+## Memperbarui downloader
+
+```bash
+npm install --global nxcode-ide@latest
+```
+
+Versi IDE terbaru tetap ditentukan oleh metadata distribusi Nxdom.
+
+## Uninstall downloader
+
+```bash
+npm uninstall --global nxcode-ide
+```
+
+Menghapus downloader npm tidak menghapus NxCode IDE yang sudah dipasang melalui
+installer Windows.
+
+## Troubleshooting
+
+### Command tidak dikenali
+
+Tutup dan buka kembali terminal setelah instalasi global, lalu pastikan folder
+global npm tersedia pada `PATH`.
+
+### Konfirmasi tidak tersedia
+
+Pada CI atau terminal non-interaktif, tambahkan `--yes`.
+
+### Verifikasi SHA-256 gagal
+
+File tidak akan dijalankan. Hapus hasil download, periksa koneksi atau proxy,
+kemudian coba lagi. Jangan membuka file yang gagal diverifikasi.
+
+### Windows menampilkan SmartScreen
+
+Pastikan sumber installer adalah release resmi Nxdom dan SHA-256 telah
+diverifikasi oleh downloader sebelum melanjutkan.
+
+## Dokumentasi
+
+- [Dokumentasi Nxdom](https://nxdom.org/docs)
+- [NxCode IDE](https://nxdom.org/#nxcode)
+- [Laporan masalah](https://github.com/Nxadom/software/issues)

package/bin/nxcode-ide.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+
+import { runCli } from "../src/cli.js";
+
+runCli(process.argv.slice(2)).catch((error) => {
+  console.error(`Error: ${error.message}`);
+  process.exitCode = 1;
+});

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "nxcode-ide",
+  "version": "1.0.0",
+  "description": "Downloader resmi NxCode Desktop IDE untuk Windows.",
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "bin": {
+    "nxcode-ide": "bin/nxcode-ide.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "screenshot"
+  ],
+  "scripts": {
+    "start": "node bin/nxcode-ide.js",
+    "test": "node --test",
+    "prepublishOnly": "npm test && node bin/nxcode-ide.js --help",
+    "publish:dry": "npm publish --dry-run"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Nxadom/software.git"
+  },
+  "homepage": "https://nxdom.org/#nxcode",
+  "bugs": {
+    "url": "https://github.com/Nxadom/software/issues"
+  },
+  "keywords": [
+    "nxcode",
+    "nxdom",
+    "ide",
+    "windows",
+    "installer",
+    "ai"
+  ],
+  "license": "MIT"
+}

package/src/cli.js

@@ -0,0 +1,196 @@
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { createInterface } from "node:readline/promises";
+import { stdin, stdout } from "node:process";
+
+import {
+  createProgressReporter,
+  defaultInstallerPath,
+  downloadInstaller,
+  reusableInstaller,
+} from "./downloader.js";
+import { assertWindows, launchInstaller } from "./launcher.js";
+import { fetchInstallerMetadata } from "./metadata.js";
+
+const packageJson = JSON.parse(
+  readFileSync(new URL("../package.json", import.meta.url), "utf8"),
+);
+
+const HELP = `NxCode Desktop IDE downloader
+
+Usage:
+  nxcode-ide install [--yes]
+  nxcode-ide download [--output <path>] [--yes]
+  nxcode-ide info [--json]
+  nxcode-ide --version
+  nxcode-ide --help
+
+Commands:
+  install    Download, verify SHA-256, lalu buka installer Windows
+  download   Download dan verifikasi installer tanpa menjalankannya
+  info       Tampilkan versi serta sumber installer terbaru
+
+Options:
+  -y, --yes           Setujui prompt non-interaktif
+  -o, --output PATH   Lokasi file untuk command download
+  --json              Output JSON untuk command info
+  -v, --version       Tampilkan versi paket downloader
+  -h, --help          Tampilkan bantuan
+
+Download resmi: https://nxdom.org/#nxcode
+`;
+
+function parseArgs(args) {
+  const options = { yes: false, json: false, output: null };
+  let command = null;
+
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (arg === "-h" || arg === "--help") return { command: "help", options };
+    if (arg === "-v" || arg === "--version") {
+      return { command: "version", options };
+    }
+    if (arg === "-y" || arg === "--yes") {
+      options.yes = true;
+      continue;
+    }
+    if (arg === "--json") {
+      options.json = true;
+      continue;
+    }
+    if (arg === "-o" || arg === "--output") {
+      const value = args[index + 1];
+      if (!value || value.startsWith("-")) {
+        throw new Error(`${arg} membutuhkan path tujuan.`);
+      }
+      options.output = value;
+      index += 1;
+      continue;
+    }
+    if (arg.startsWith("--output=")) {
+      options.output = arg.slice("--output=".length);
+      if (!options.output) throw new Error("--output membutuhkan path tujuan.");
+      continue;
+    }
+    if (arg.startsWith("-")) throw new Error(`Opsi tidak dikenal: ${arg}`);
+    if (command) throw new Error(`Argumen tidak dikenal: ${arg}`);
+    command = arg;
+  }
+
+  return { command: command ?? "help", options };
+}
+
+async function terminalConfirm(message, { input = stdin, output = stdout } = {}) {
+  if (!input.isTTY) {
+    throw new Error("Konfirmasi interaktif tidak tersedia. Gunakan --yes.");
+  }
+  const prompt = createInterface({ input, output });
+  try {
+    const answer = await prompt.question(`${message} [y/N] `);
+    return /^(y|yes|ya)$/i.test(answer.trim());
+  } finally {
+    prompt.close();
+  }
+}
+
+function formatMegabytes(bytes) {
+  return `${(bytes / 1024 / 1024).toFixed(1)} MB`;
+}
+
+function printMetadata(metadata, output) {
+  output.write(`NxCode IDE ${metadata.version}\n`);
+  output.write(`${metadata.label || "Windows 64-bit"}\n`);
+  output.write(`Ukuran: ${formatMegabytes(metadata.size)}\n`);
+  output.write(`SHA-256: ${metadata.sha256}\n`);
+  output.write(`Release: ${metadata.releaseUrl}\n`);
+  output.write(`Installer: ${metadata.url}\n`);
+}
+
+export async function runCli(
+  args,
+  {
+    output = stdout,
+    input = stdin,
+    platform = process.platform,
+    cwd = process.cwd(),
+    getMetadata = fetchInstallerMetadata,
+    download = downloadInstaller,
+    isReusable = reusableInstaller,
+    launch = launchInstaller,
+    confirm = (message) => terminalConfirm(message, { input, output }),
+  } = {},
+) {
+  const { command, options } = parseArgs(args);
+
+  if (command === "help") {
+    output.write(HELP);
+    return { command };
+  }
+  if (command === "version") {
+    output.write(`${packageJson.version}\n`);
+    return { command, version: packageJson.version };
+  }
+  if (!["install", "download", "info"].includes(command)) {
+    throw new Error(`Command tidak dikenal: ${command}. Gunakan --help.`);
+  }
+  if (options.output && command !== "download") {
+    throw new Error("--output hanya dapat digunakan dengan command download.");
+  }
+  if (options.json && command !== "info") {
+    throw new Error("--json hanya dapat digunakan dengan command info.");
+  }
+  if (command === "install") assertWindows(platform);
+
+  const metadata = await getMetadata();
+  if (command === "info") {
+    if (options.json) output.write(`${JSON.stringify(metadata, null, 2)}\n`);
+    else printMetadata(metadata, output);
+    return { command, metadata };
+  }
+
+  const destination =
+    command === "install"
+      ? defaultInstallerPath(metadata)
+      : resolve(cwd, options.output ?? metadata.assetName);
+  let cached = await isReusable(destination, metadata);
+
+  if (!cached && !options.yes) {
+    const accepted = await confirm(
+      `Unduh NxCode IDE ${metadata.version} (${formatMegabytes(metadata.size)})?`,
+    );
+    if (!accepted) {
+      output.write("Download dibatalkan.\n");
+      return { command, cancelled: true };
+    }
+  }
+
+  if (!cached) {
+    const progress = createProgressReporter(output);
+    await download(metadata, {
+      destination,
+      onProgress: progress,
+    });
+    if (output.isTTY) output.write("\n");
+  } else {
+    output.write("Installer terverifikasi ditemukan di cache.\n");
+  }
+  output.write(`Installer terverifikasi: ${destination}\n`);
+
+  if (command === "download") {
+    return { command, path: destination, metadata, cached };
+  }
+
+  if (!options.yes) {
+    const accepted = await confirm("Buka installer NxCode IDE sekarang?");
+    if (!accepted) {
+      output.write("Installer tidak dibuka. File tetap tersimpan di cache.\n");
+      return { command, path: destination, launched: false };
+    }
+  }
+
+  launch(destination, { platform });
+  output.write("Installer NxCode IDE dibuka.\n");
+  return { command, path: destination, launched: true };
+}
+
+export { HELP, parseArgs };

package/src/downloader.js

@@ -0,0 +1,137 @@
+import { createHash } from "node:crypto";
+import { createWriteStream } from "node:fs";
+import {
+  mkdir,
+  rename,
+  rm,
+  stat,
+} from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { basename, dirname, join, resolve } from "node:path";
+import { Readable, Transform } from "node:stream";
+import { pipeline } from "node:stream/promises";
+
+function formatBytes(value) {
+  const bytes = Math.max(0, Number(value) || 0);
+  if (bytes < 1024) return `${bytes} B`;
+  const units = ["KB", "MB", "GB"];
+  let amount = bytes;
+  let index = -1;
+  do {
+    amount /= 1024;
+    index += 1;
+  } while (amount >= 1024 && index < units.length - 1);
+  return `${amount.toFixed(amount >= 10 ? 1 : 2)} ${units[index]}`;
+}
+
+export function defaultInstallerPath(metadata) {
+  return join(tmpdir(), "nxcode-ide", metadata.assetName);
+}
+
+export function createProgressReporter(output = process.stdout) {
+  let lastPercent = -1;
+  return ({ downloaded, total }) => {
+    const percent = total > 0 ? Math.min(100, Math.floor((downloaded / total) * 100)) : 0;
+    if (percent === lastPercent && downloaded !== total) return;
+    lastPercent = percent;
+    const line =
+      `Mengunduh ${String(percent).padStart(3)}% · ` +
+      `${formatBytes(downloaded)} / ${formatBytes(total)}`;
+    if (output?.isTTY) output.write(`\r\x1b[2K${line}`);
+    else if (percent === 100 || percent % 10 === 0) output.write(`${line}\n`);
+  };
+}
+
+export async function verifyInstaller(path, metadata) {
+  const file = await import("node:fs").then(({ createReadStream }) =>
+    createReadStream(path),
+  );
+  const hash = createHash("sha256");
+  let size = 0;
+  for await (const chunk of file) {
+    hash.update(chunk);
+    size += chunk.length;
+  }
+  return {
+    ok: size === metadata.size && hash.digest("hex") === metadata.sha256,
+    size,
+  };
+}
+
+export async function downloadInstaller(
+  metadata,
+  {
+    fetchImpl = globalThis.fetch,
+    destination = defaultInstallerPath(metadata),
+    onProgress = createProgressReporter(),
+  } = {},
+) {
+  const target = resolve(destination);
+  if (basename(target).toLowerCase().endsWith(".exe") === false) {
+    throw new Error("Tujuan download harus berupa file .exe.");
+  }
+
+  await mkdir(dirname(target), { recursive: true });
+  const partial = `${target}.${process.pid}.${Date.now()}.part`;
+  let response;
+  try {
+    response = await fetchImpl(metadata.url, {
+      redirect: "follow",
+      headers: { "user-agent": "nxcode-ide-npm" },
+    });
+    if (!response?.ok || !response.body) {
+      throw new Error(
+        `Download installer gagal (HTTP ${response?.status ?? "unknown"}).`,
+      );
+    }
+
+    const hash = createHash("sha256");
+    let downloaded = 0;
+    const source = Readable.fromWeb(response.body);
+    const output = createWriteStream(partial, { flags: "wx" });
+    const meter = new Transform({
+      transform(chunk, _encoding, callback) {
+        downloaded += chunk.length;
+        if (downloaded > metadata.size) {
+          callback(
+            new Error("Ukuran installer melebihi metadata GitHub Release."),
+          );
+          return;
+        }
+        hash.update(chunk);
+        onProgress?.({ downloaded, total: metadata.size });
+        callback(null, chunk);
+      },
+    });
+
+    await pipeline(source, meter, output);
+
+    if (downloaded !== metadata.size) {
+      throw new Error(
+        `Ukuran installer tidak cocok: ${downloaded} dari ${metadata.size} byte.`,
+      );
+    }
+    const digest = hash.digest("hex");
+    if (digest !== metadata.sha256) {
+      throw new Error("Verifikasi SHA-256 installer gagal.");
+    }
+
+    await rm(target, { force: true });
+    await rename(partial, target);
+    onProgress?.({ downloaded, total: metadata.size });
+    return target;
+  } catch (error) {
+    await rm(partial, { force: true }).catch(() => {});
+    throw error;
+  }
+}
+
+export async function reusableInstaller(path, metadata) {
+  try {
+    const info = await stat(path);
+    if (!info.isFile() || info.size !== metadata.size) return false;
+    return (await verifyInstaller(path, metadata)).ok;
+  } catch {
+    return false;
+  }
+}

package/src/launcher.js

@@ -0,0 +1,23 @@
+import { spawn } from "node:child_process";
+
+export function assertWindows(platform = process.platform) {
+  if (platform !== "win32") {
+    throw new Error(
+      "NxCode IDE saat ini hanya tersedia untuk Windows 10/11 64-bit.",
+    );
+  }
+}
+
+export function launchInstaller(
+  installerPath,
+  { platform = process.platform, spawnImpl = spawn } = {},
+) {
+  assertWindows(platform);
+  const child = spawnImpl(installerPath, [], {
+    detached: true,
+    stdio: "ignore",
+    windowsHide: false,
+  });
+  child.unref?.();
+  return child;
+}

package/src/metadata.js

@@ -0,0 +1,126 @@
+export const DOWNLOAD_METADATA_URL = "https://nxdom.org/download.json";
+
+const ALLOWED_DOWNLOAD_HOST = "github.com";
+const VERSION_PATTERN = /^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?$/;
+const RELEASE_PATH_PATTERN =
+  /^\/([^/]+)\/([^/]+)\/releases\/download\/([^/]+)\/([^/]+)$/;
+
+function assertResponse(response, label) {
+  if (!response?.ok) {
+    throw new Error(`${label} gagal (HTTP ${response?.status ?? "unknown"}).`);
+  }
+}
+
+export function parseReleaseUrl(value) {
+  let url;
+  try {
+    url = new URL(value);
+  } catch {
+    throw new Error("URL installer pada metadata tidak valid.");
+  }
+
+  if (url.protocol !== "https:" || url.hostname !== ALLOWED_DOWNLOAD_HOST) {
+    throw new Error("URL installer harus memakai HTTPS dari github.com.");
+  }
+
+  const match = url.pathname.match(RELEASE_PATH_PATTERN);
+  if (!match) {
+    throw new Error("URL installer bukan asset GitHub Release yang valid.");
+  }
+
+  const [, owner, repo, tag, encodedAssetName] = match;
+  const assetName = decodeURIComponent(encodedAssetName);
+  if (
+    !assetName ||
+    assetName === "." ||
+    assetName === ".." ||
+    assetName.includes("/") ||
+    assetName.includes("\\") ||
+    !assetName.toLowerCase().endsWith(".exe")
+  ) {
+    throw new Error("Nama asset installer tidak aman.");
+  }
+  return {
+    url: url.href,
+    owner,
+    repo,
+    tag: decodeURIComponent(tag),
+    assetName,
+  };
+}
+
+export function validateDownloadMetadata(value) {
+  if (!value || typeof value !== "object") {
+    throw new Error("Format metadata download tidak valid.");
+  }
+
+  const version = String(value.version ?? "").trim();
+  const label = String(value.label ?? "").trim();
+  if (!VERSION_PATTERN.test(version)) {
+    throw new Error("Versi NxCode pada metadata tidak valid.");
+  }
+
+  const release = parseReleaseUrl(value.url);
+  if (release.tag !== `v${version}` && release.tag !== version) {
+    throw new Error("Versi metadata tidak cocok dengan tag GitHub Release.");
+  }
+
+  return { version, label, ...release };
+}
+
+export async function fetchInstallerMetadata({
+  fetchImpl = globalThis.fetch,
+  metadataUrl = DOWNLOAD_METADATA_URL,
+} = {}) {
+  if (typeof fetchImpl !== "function") {
+    throw new Error("Runtime Node.js ini tidak menyediakan fetch.");
+  }
+
+  const metadataResponse = await fetchImpl(metadataUrl, {
+    headers: { accept: "application/json" },
+  });
+  assertResponse(metadataResponse, "Pengambilan metadata NxCode");
+  const metadata = validateDownloadMetadata(await metadataResponse.json());
+
+  const releaseApiUrl =
+    `https://api.github.com/repos/${encodeURIComponent(metadata.owner)}/` +
+    `${encodeURIComponent(metadata.repo)}/releases/tags/${encodeURIComponent(metadata.tag)}`;
+  const releaseResponse = await fetchImpl(releaseApiUrl, {
+    headers: {
+      accept: "application/vnd.github+json",
+      "user-agent": "nxcode-ide-npm",
+      "x-github-api-version": "2022-11-28",
+    },
+  });
+  assertResponse(releaseResponse, "Pengambilan data GitHub Release");
+
+  const release = await releaseResponse.json();
+  const asset = Array.isArray(release?.assets)
+    ? release.assets.find(
+        (entry) =>
+          entry?.name === metadata.assetName &&
+          entry?.browser_download_url === metadata.url,
+      )
+    : null;
+  if (!asset) {
+    throw new Error("Asset installer tidak ditemukan pada GitHub Release.");
+  }
+
+  const digest = String(asset.digest ?? "");
+  const digestMatch = digest.match(/^sha256:([a-f0-9]{64})$/i);
+  if (!digestMatch) {
+    throw new Error("GitHub Release belum menyediakan digest SHA-256.");
+  }
+
+  const size = Number(asset.size);
+  if (!Number.isSafeInteger(size) || size <= 0) {
+    throw new Error("Ukuran asset GitHub Release tidak valid.");
+  }
+
+  return {
+    ...metadata,
+    size,
+    sha256: digestMatch[1].toLowerCase(),
+    releaseUrl: String(release.html_url ?? ""),
+  };
+}