@akaanakbaik/pterodactyl-gateway 0.3.0 → 0.4.0

package/add-promt.md

@@ -1,12 +1,12 @@
 # Add Prompt Integrasi Akadev Pterodactyl Gateway
 
-Gunakan dokumen ini sebagai prompt tambahan saat meminta AI mengintegrasikan package `@akadev/pterodactyl-gateway` ke project Node.js, bot, dashboard, atau backend API.
+Gunakan dokumen ini sebagai prompt tambahan saat meminta AI mengintegrasikan package `@akaanakbaik/pterodactyl-gateway` ke project Node.js, bot, dashboard, atau backend API.
 
 ## Prompt siap pakai
 
-Tolong integrasikan package `@akadev/pterodactyl-gateway` ke project saya dengan aman, rapi, dan mudah dipahami pemula.
+Tolong integrasikan package `@akaanakbaik/pterodactyl-gateway` ke project saya dengan aman, rapi, dan mudah dipahami pemula.
 
-Package ini adalah SDK TypeScript untuk Pterodactyl Panel. Gunakan untuk koneksi panel, membuat user, membuat server, preview create server, dry run, kontrol server, dan raw request.
+Package ini adalah SDK TypeScript dan CLI untuk Pterodactyl Panel. Gunakan untuk koneksi panel, membuat user, membuat server, preview create server, dry-run, kontrol server, file manager, startup variables, backup, schedule, network/ports, lifecycle server, dan raw request.
 
 Gunakan env berikut:
 
@@ -18,10 +18,24 @@ PTERO_PTLC=isi_client_api_key
 
 Jangan hardcode API key atau password di source code.
 
+## Install
+
+```bash
+npm i @akaanakbaik/pterodactyl-gateway
+```
+
+Untuk CLI global:
+
+```bash
+npm i -g @akaanakbaik/pterodactyl-gateway
+ptero-gateway help
+ptg help
+```
+
 ## Cara koneksi
 
 ```ts
-import { createPtero } from "@akadev/pterodactyl-gateway";
+import { createPtero } from "@akaanakbaik/pterodactyl-gateway";
 
 const ptero = createPtero.fromEnv();
 await ptero.connect();
@@ -37,7 +51,7 @@ const ptero = createPtero({
 });
 ```
 
-## Fitur utama
+## Fitur utama SDK
 
 - `ptero.connect()` untuk cek koneksi.
 - `ptero.doctor()` untuk diagnosa konfigurasi.
@@ -46,20 +60,97 @@ const ptero = createPtero({
 - `ptero.servers.previewCreate()` untuk melihat payload final sebelum create server.
 - `ptero.servers.createSmart()` untuk create server dengan auto docker image, startup, environment, default allocation, dan additional allocation.
 - `ptero.servers.createFromPreset()` untuk create server dari preset spek.
-- `ptero.server(identifier).start()` untuk start server.
-- `ptero.server(identifier).stop()` untuk stop server.
-- `ptero.server(identifier).restart()` untuk restart server.
-- `ptero.server(identifier).kill()` untuk kill server.
+- `ptero.server(identifier).probe()` untuk cek endpoint client secara read-only.
+- `ptero.server(identifier).resources()` untuk resource server.
+- `ptero.server(identifier).start()`, `stop()`, `restart()`, `kill()` untuk power control.
 - `ptero.server(identifier).command("npm start")` untuk kirim command.
-- `ptero.server(identifier).resources()` untuk mengambil resource server.
+- `ptero.server(identifier).files.*` untuk file manager.
+- `ptero.server(identifier).startup.*` untuk startup variables.
+- `ptero.server(identifier).network.*` untuk allocation/ports.
+- `ptero.server(identifier).databases.*` untuk database manager.
+- `ptero.server(identifier).backups.*` untuk backup manager.
+- `ptero.server(identifier).schedules.*` untuk schedule manager.
 - `ptero.raw.application` dan `ptero.raw.client` untuk endpoint yang belum tersedia wrapper.
 
+## Fitur CLI penting
+
+```bash
+ptero-gateway doctor
+ptero-gateway connect
+ptero-gateway ids
+ptero-gateway ids --nest 5
+ptero-gateway admin users
+ptero-gateway admin servers
+ptero-gateway servers
+```
+
+Create server dry-run:
+
+```bash
+ptero-gateway admin create-server \
+  --name "aka test" \
+  --email "user@example.com" \
+  --username "aka_test" \
+  --password "password aman" \
+  --node 1 \
+  --nest 5 \
+  --egg 18 \
+  --memory 1GB \
+  --disk 2GB \
+  --cpu 100% \
+  --databases 0 \
+  --allocations 1 \
+  --backups 0 \
+  --dry-run
+```
+
+Create server asli:
+
+```bash
+ptero-gateway admin create-server \
+  --name "aka test" \
+  --email "user@example.com" \
+  --username "aka_test" \
+  --password "password aman" \
+  --node 1 \
+  --nest 5 \
+  --egg 18 \
+  --memory 1GB \
+  --disk 2GB \
+  --cpu 100% \
+  --databases 0 \
+  --allocations 1 \
+  --backups 0 \
+  --yes
+```
+
+Kontrol server:
+
+```bash
+ptero-gateway probe 311d56b7
+ptero-gateway server 311d56b7 summary
+ptero-gateway server 311d56b7 resources
+ptero-gateway server 311d56b7 files /
+ptero-gateway server 311d56b7 env
+ptero-gateway server 311d56b7 ports
+ptero-gateway server 311d56b7 start --yes
+ptero-gateway server 311d56b7 stop --yes
+```
+
+Template Node alive:
+
+```bash
+ptero-gateway server 311d56b7 stop --yes
+ptero-gateway server 311d56b7 init-node-alive --yes
+ptero-gateway server 311d56b7 start --yes
+```
+
 ## Create user
 
 ```ts
 const user = await ptero.users.createSmart({
-  username: "aka",
-  email: "aka@example.com",
+  username: "aka_test",
+  email: "user@example.com",
   password: "auto",
   administrator: "no"
 });
@@ -72,18 +163,21 @@ Jika `password` diisi `auto`, package membuat password aman dan mengembalikannya
 ```ts
 const server = await ptero.servers.createSmart({
   name: "Bot WhatsApp Aka",
-  email: "aka@example.com",
+  email: "user@example.com",
+  username: "aka_test",
+  password: "password aman",
+  autoCreateUser: true,
   description: "Server bot WhatsApp untuk Aka",
   nodeId: 1,
   nestId: 5,
-  eggId: 15,
+  eggId: 18,
   specs: {
-    memory: "2GB",
-    disk: "5GB",
+    memory: "1GB",
+    disk: "2GB",
     cpu: "100%",
-    databases: 1,
+    databases: 0,
     allocations: 1,
-    backups: 1
+    backups: 0
   }
 });
 ```
@@ -114,9 +208,8 @@ const server = await ptero.servers.createSmart({
 - block IO default `500`
 - CPU pinning default kosong
 - OOM disabled default `false`
-- start on completion default `true`
 
-## Preview dan dry run
+## Preview dan dry-run
 
 ```ts
 const preview = await ptero.servers.previewCreate(input);
@@ -128,39 +221,10 @@ const result = await ptero.servers.createSmart(input, { dryRun: true });
 console.log(result.payload);
 ```
 
-## Preset paket
-
-```ts
-const ptero = createPtero({
-  domain: process.env.PTERO_DOMAIN,
-  ptla: process.env.PTERO_PTLA,
-  ptlc: process.env.PTERO_PTLC,
-  presets: {
-    basic: {
-      memory: "2GB",
-      disk: "5GB",
-      cpu: "100%",
-      databases: 1,
-      allocations: 1,
-      backups: 1
-    }
-  }
-});
-
-await ptero.servers.createFromPreset("basic", {
-  name: "Bot Aka",
-  email: "aka@example.com",
-  description: "Paket Basic",
-  nodeId: 1,
-  nestId: 5,
-  eggId: 15
-});
-```
-
 ## Error handling
 
 ```ts
-import { explainError } from "@akadev/pterodactyl-gateway";
+import { explainError } from "@akaanakbaik/pterodactyl-gateway";
 
 try {
   await ptero.servers.createSmart(input);
@@ -187,6 +251,9 @@ await ptero.raw.client.post("/servers/abc123/command", {
 - Gunakan `previewCreate()` atau `dryRun` sebelum create server final.
 - Gunakan `explainError()` untuk pesan error yang mudah dipahami.
 - Create server wajib memakai `nodeId`, `nestId`, dan `eggId` berupa angka.
-- Jika ID node, nest, atau egg salah, arahkan user untuk cek di Admin Panel Pterodactyl.
+- Jika ID node, nest, atau egg salah, arahkan user untuk cek `ptero-gateway ids` atau Admin Panel Pterodactyl.
 - Jika allocation kosong, arahkan user menambah allocation di Admin Panel > Nodes > Allocations.
-- Jangan jalankan command berisiko tanpa izin jelas dari user.
+- Semua aksi yang mengubah server via CLI wajib memakai `--yes`.
+- Write file via CLI default hanya boleh ke `/tmp`; untuk path lain wajib `--allow-any-path`.
+- Jangan menjalankan command berisiko tanpa izin jelas dari user.
+- Delete server/user permanen belum dibuka di v0.3.0 dan perlu guard tambahan.

package/dist/cli-entry.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli-entry.d.ts.map

package/dist/cli-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-entry.d.ts","sourceRoot":"","sources":["../src/cli-entry.ts"],"names":[],"mappings":""}

package/dist/cli-entry.js

@@ -0,0 +1,179 @@
+#!/usr/bin/env node
+const rawArgs = process.argv.slice(2);
+const command = rawArgs[0] ?? "help";
+const jsonMode = rawArgs.includes("--json");
+const EXPLAINS = {
+    DOMAIN_REQUIRED: {
+        title: "Domain panel belum diisi",
+        reason: "Env PTERO_DOMAIN belum tersedia atau config createPtero belum berisi domain/panelUrl.",
+        fix: [
+            "export PTERO_DOMAIN=\"https://panel.example.com\"",
+            "pastikan tidak ada spasi/kutip rusak pada env",
+            "jalankan ulang: ptero-gateway doctor"
+        ]
+    },
+    PTLA_REQUIRED: {
+        title: "Application API Key belum diisi",
+        reason: "Aksi admin membutuhkan PTERO_PTLA.",
+        fix: [
+            "buat Application API Key di panel admin Pterodactyl",
+            "export PTERO_PTLA=\"ptla_xxx\"",
+            "jalankan: ptero-gateway doctor"
+        ]
+    },
+    PTLC_REQUIRED: {
+        title: "Client API Key belum diisi",
+        reason: "Aksi client server membutuhkan PTERO_PTLC.",
+        fix: [
+            "buat Client API Key dari account panel",
+            "export PTERO_PTLC=\"ptlc_xxx\"",
+            "jalankan: ptero-gateway doctor"
+        ]
+    },
+    DOCKER_IMAGE_NOT_FOUND: {
+        title: "Docker image egg tidak ditemukan",
+        reason: "Egg tidak mengirim docker_image/docker_images yang bisa dipilih otomatis.",
+        fix: [
+            "cek egg ID dengan: ptero-gateway ids --nest <nestId>",
+            "pastikan egg punya Docker Images di panel",
+            "atau isi manual: --docker-image ghcr.io/parkervcp/yolks:nodejs_22"
+        ]
+    },
+    STARTUP_VARIABLE_NOT_FOUND: {
+        title: "Startup variable tidak ditemukan",
+        reason: "Nama variable yang di-set tidak cocok dengan env_variable pada egg/server.",
+        fix: [
+            "lihat variable: ptero-gateway server <identifier> env",
+            "salin nama variable dari kolom variable",
+            "jalankan: ptero-gateway server <identifier> set-env KEY VALUE --yes"
+        ]
+    },
+    VALIDATION_ERROR: {
+        title: "Payload ditolak panel",
+        reason: "Ada field yang tidak sesuai validasi Pterodactyl.",
+        fix: [
+            "jalankan create-server dengan --dry-run dulu",
+            "cek node, nest, egg, allocation, dan feature limits",
+            "pakai --json untuk melihat payload lengkap"
+        ]
+    },
+    REQUEST_FAILED: {
+        title: "Request ke panel gagal",
+        reason: "Panel mengembalikan error HTTP atau response tidak sesuai.",
+        fix: [
+            "cek domain dan API key dengan: ptero-gateway doctor",
+            "pastikan endpoint didukung versi panel",
+            "coba ulang dengan --json untuk melihat response mentah"
+        ]
+    },
+    BACKUP_LIMIT: {
+        title: "Limit backup habis",
+        reason: "Server tidak punya jatah backup atau sudah mencapai limit.",
+        fix: [
+            "cek: ptero-gateway admin server <id> limits",
+            "update: ptero-gateway admin server <id> update-limits --backups 1 --yes",
+            "lalu ulangi create-backup"
+        ]
+    },
+    EEXIST: {
+        title: "Binary global sudah ada",
+        reason: "File /usr/bin/ptero-gateway atau /usr/bin/ptg masih ada dari npm link/install lama.",
+        fix: [
+            "npm unlink -g @akaanakbaik/pterodactyl-gateway 2>/dev/null || true",
+            "rm -f /usr/bin/ptero-gateway /usr/bin/ptg",
+            "npm i -g @akaanakbaik/pterodactyl-gateway"
+        ]
+    },
+    E404: {
+        title: "Package atau endpoint tidak ditemukan",
+        reason: "NPM/package/endpoint belum tersedia atau nama salah.",
+        fix: [
+            "cek nama package atau identifier server",
+            "untuk npm: npm view @akaanakbaik/pterodactyl-gateway@latest",
+            "untuk server: ptero-gateway servers lalu salin identifier"
+        ]
+    }
+};
+if (command === "help" || command === "--help" || command === "-h") {
+    printHelp();
+}
+else if (command === "env-template") {
+    const content = [
+        "PTERO_DOMAIN=https://panel.example.com",
+        "PTERO_PTLA=ptla_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+        "PTERO_PTLC=ptlc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+    ].join("\n");
+    console.log(content);
+}
+else if (command === "explain") {
+    const code = (rawArgs[1] ?? "").toUpperCase();
+    const result = EXPLAINS[code];
+    if (jsonMode) {
+        console.log(JSON.stringify(result ?? { error: "UNKNOWN_EXPLAIN", code }, null, 2));
+    }
+    else if (!code || !result) {
+        console.log(`Kode error tersedia:\n${Object.keys(EXPLAINS).map(item => `- ${item}`).join("\n")}\n\nContoh: ptero-gateway explain DOMAIN_REQUIRED`);
+    }
+    else {
+        console.log(`${result.title}\n\nPenyebab:\n${result.reason}\n\nCara perbaikan:\n${result.fix.map((item, index) => `${index + 1}. ${item}`).join("\n")}`);
+    }
+}
+else {
+    await import("./cli.js");
+}
+function printHelp() {
+    console.log(`Akadev Pterodactyl Gateway
+
+Perintah:
+  ptero-gateway presets [--json]
+  ptero-gateway explain <ERROR_CODE> [--json]
+  ptero-gateway env-template
+  ptero-gateway doctor [--json]
+  ptero-gateway connect [--json]
+  ptero-gateway ids [--nest <nestId>] [--json]
+  ptero-gateway servers [--json]
+  ptero-gateway admin users [--json]
+  ptero-gateway admin servers [--json]
+  ptero-gateway admin create-user --username aka_test --email user@example.com --password "secret" --yes
+  ptero-gateway admin create-server --name "aka test" --email user@example.com --node 1 --nest 5 --egg 18 --preset basic --dry-run
+  ptero-gateway admin create-server --name "aka test" --email user@example.com --node 1 --nest 5 --egg 18 --preset standard --yes
+  ptero-gateway admin server <serverId> detail [--json]
+  ptero-gateway admin server <serverId> limits [--json]
+  ptero-gateway admin server <serverId> update-limits --backups 1 --yes
+  ptero-gateway admin server <serverId> suspend --yes
+  ptero-gateway admin server <serverId> unsuspend --yes
+  ptero-gateway admin server <serverId> reinstall --yes
+  ptero-gateway probe <identifier> [--json]
+  ptero-gateway server <identifier> summary [--json]
+  ptero-gateway server <identifier> resources [--json]
+  ptero-gateway server <identifier> files [directory] [--json]
+  ptero-gateway server <identifier> read <file>
+  ptero-gateway server <identifier> startup|env [--json]
+  ptero-gateway server <identifier> network|ports [--json]
+  ptero-gateway server <identifier> databases [--json]
+  ptero-gateway server <identifier> backups [--json]
+  ptero-gateway server <identifier> backup <uuid> [--json]
+  ptero-gateway server <identifier> delete-backup <uuid> --yes
+  ptero-gateway server <identifier> schedules [--json]
+  ptero-gateway server <identifier> write /tmp/test.txt "isi file" --yes
+  ptero-gateway server <identifier> write /index.js "isi file" --yes --allow-any-path
+  ptero-gateway server <identifier> init-node-alive --yes
+  ptero-gateway server <identifier> set-env KEY VALUE --yes
+  ptero-gateway server <identifier> create-backup --name "backup-name" --yes
+  ptero-gateway server <identifier> start --yes
+  ptero-gateway server <identifier> stop --yes
+  ptero-gateway server <identifier> restart --yes
+  ptero-gateway server <identifier> kill --yes
+  ptero-gateway server <identifier> command "npm start" --yes
+
+Preset:
+  mini, basic, standard, premium, unlimited
+  Spek preset bisa dioverride dengan --memory, --disk, --cpu, --databases, --allocations, --backups.
+
+Env:
+  PTERO_DOMAIN=https://panel.example.com
+  PTERO_PTLA=ptla_xxx
+  PTERO_PTLC=ptlc_xxx`);
+}
+export {};
+//# sourceMappingURL=cli-entry.js.map

package/dist/cli-entry.js.map

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

package/dist/cli.js

@@ -7,11 +7,23 @@ const dryRunMode = rawArgs.includes("--dry-run");
 const allowAnyPath = rawArgs.includes("--allow-any-path");
 const args = rawArgs.filter(arg => arg !== "--json" && arg !== "--yes" && arg !== "-y" && arg !== "--dry-run" && arg !== "--allow-any-path");
 const command = args[0] ?? "help";
+const SERVER_PRESETS = {
+    mini: { memory: "512MB", disk: "1GB", cpu: "50%", databases: 0, allocations: 1, backups: 0, swap: 0, io: 500, description: "Ringan untuk bot kecil atau testing." },
+    basic: { memory: "1GB", disk: "2GB", cpu: "100%", databases: 0, allocations: 1, backups: 0, swap: 0, io: 500, description: "Default aman untuk bot Node.js sederhana." },
+    standard: { memory: "2GB", disk: "5GB", cpu: "200%", databases: 1, allocations: 1, backups: 1, swap: 0, io: 500, description: "Untuk bot/API sedang dan project aktif." },
+    premium: { memory: "4GB", disk: "10GB", cpu: "300%", databases: 2, allocations: 2, backups: 2, swap: 0, io: 500, description: "Untuk project lebih berat dan butuh backup." },
+    unlimited: { memory: "0", disk: "0", cpu: "0", databases: 5, allocations: 3, backups: 3, swap: 0, io: 500, description: "Resource unlimited sesuai aturan Pterodactyl." }
+};
 async function main() {
     if (command === "help" || command === "--help" || command === "-h") {
         printHelp();
         return;
     }
+    if (command === "presets") {
+        const rows = formatPresetRows();
+        output(rows, table(rows, ["name", "memory", "disk", "cpu", "databases", "allocations", "backups", "description"]));
+        return;
+    }
     const ptero = createPtero.fromEnv();
     if (command === "doctor") {
         const report = await ptero.doctor();
@@ -294,6 +306,7 @@ function errorResult(error) {
 function buildCreateServerInput() {
     const username = getOption("--username");
     const password = getOption("--password");
+    const preset = getServerPreset(getOption("--preset") ?? "basic");
     return {
         name: getRequiredOption("--name"),
         email: getRequiredOption("--email"),
@@ -307,17 +320,34 @@ function buildCreateServerInput() {
         dockerImage: getOption("--docker-image") ?? "auto",
         startup: getOption("--startup") ?? "auto",
         specs: {
-            memory: getOption("--memory") ?? "1GB",
-            disk: getOption("--disk") ?? "2GB",
-            cpu: getOption("--cpu") ?? "100%",
-            databases: getNumberOption("--databases", 0),
-            allocations: getNumberOption("--allocations", 1),
-            backups: getNumberOption("--backups", 0),
-            swap: getNumberOption("--swap", 0),
-            io: getNumberOption("--io", 500)
+            memory: getOption("--memory") ?? preset.memory,
+            disk: getOption("--disk") ?? preset.disk,
+            cpu: getOption("--cpu") ?? preset.cpu,
+            databases: getNumberOption("--databases", preset.databases),
+            allocations: getNumberOption("--allocations", preset.allocations),
+            backups: getNumberOption("--backups", preset.backups),
+            swap: getNumberOption("--swap", preset.swap),
+            io: getNumberOption("--io", preset.io)
         }
     };
 }
+function getServerPreset(name) {
+    if (!(name in SERVER_PRESETS))
+        throw new Error(`Preset tidak dikenal: ${name}. Jalankan: ptero-gateway presets`);
+    return SERVER_PRESETS[name];
+}
+function formatPresetRows() {
+    return Object.entries(SERVER_PRESETS).map(([name, preset]) => ({
+        name,
+        memory: preset.memory,
+        disk: preset.disk,
+        cpu: preset.cpu,
+        databases: String(preset.databases),
+        allocations: String(preset.allocations),
+        backups: String(preset.backups),
+        description: preset.description
+    }));
+}
 function buildLimitPayload(raw) {
     const attributes = getAttributes(raw);
     const limits = asRecord(attributes.limits);
@@ -626,6 +656,7 @@ function printHelp() {
     console.log(`Akadev Pterodactyl Gateway
 
 Perintah:
+  ptero-gateway presets [--json]
   ptero-gateway doctor [--json]
   ptero-gateway connect [--json]
   ptero-gateway ids [--nest <nestId>] [--json]
@@ -633,8 +664,8 @@ Perintah:
   ptero-gateway admin users [--json]
   ptero-gateway admin servers [--json]
   ptero-gateway admin create-user --username aka_test --email user@example.com --password "secret" --yes
-  ptero-gateway admin create-server --name "aka test" --email user@example.com --node 1 --nest 5 --egg 18 --dry-run
-  ptero-gateway admin create-server --name "aka test" --email user@example.com --node 1 --nest 5 --egg 18 --yes
+  ptero-gateway admin create-server --name "aka test" --email user@example.com --node 1 --nest 5 --egg 18 --preset basic --dry-run
+  ptero-gateway admin create-server --name "aka test" --email user@example.com --node 1 --nest 5 --egg 18 --preset standard --yes
   ptero-gateway admin server <serverId> detail [--json]
   ptero-gateway admin server <serverId> limits [--json]
   ptero-gateway admin server <serverId> update-limits --backups 1 --yes
@@ -664,6 +695,10 @@ Perintah:
   ptero-gateway server <identifier> kill --yes
   ptero-gateway server <identifier> command "npm start" --yes
 
+Preset:
+  mini, basic, standard, premium, unlimited
+  Spek preset bisa dioverride dengan --memory, --disk, --cpu, --databases, --allocations, --backups.
+
 Env:
   PTERO_DOMAIN=https://panel.example.com
   PTERO_PTLA=ptla_xxx