@phreshos/cli 0.1.5 → 0.1.7

package/dist/system/service/linux.js

@@ -0,0 +1,99 @@
+import { execute } from "../process.js";
+import { existsSync } from "node:fs";
+import { mkdir, rename, rm, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { randomUUID } from "node:crypto";
+const command = "systemctl";
+const unit = "phreshos.service";
+export default class LinuxSystemService {
+    run;
+    file;
+    constructor(userHome, run = execute) {
+        this.run = run;
+        this.file = join(userHome, ".config", "systemd", "user", unit);
+    }
+    async inspect() {
+        const registered = existsSync(this.file);
+        const active = await this.run(command, ["--user", "is-active", "--quiet", unit]);
+        const enabled = await this.run(command, ["--user", "is-enabled", "--quiet", unit]);
+        const pid = active.code === 0 ? await this.run(command, ["--user", "show", unit, "--property", "MainPID", "--value"]) : undefined;
+        const value = pid && /^[0-9]+$/.test(pid.stdout.trim()) ? Number(pid.stdout.trim()) : undefined;
+        return {
+            registered,
+            enabled: registered && enabled.code === 0,
+            running: registered && active.code === 0,
+            ...(value ? { pid: value } : {})
+        };
+    }
+    async register(definition) {
+        await this.stop();
+        await mkdir(dirname(this.file), { recursive: true });
+        await mkdir(dirname(definition.output), { recursive: true });
+        const temporary = `${this.file}.${randomUUID()}.tmp`;
+        try {
+            await writeFile(temporary, service(definition), { mode: 0o600 });
+            await rename(temporary, this.file);
+        }
+        finally {
+            await rm(temporary, { force: true });
+        }
+        await this.require(["--user", "daemon-reload"]);
+    }
+    async unregister() {
+        await this.stop();
+        await this.run(command, ["--user", "disable", unit]);
+        await rm(this.file, { force: true });
+        await this.require(["--user", "daemon-reload"]);
+        await this.run(command, ["--user", "reset-failed", unit]);
+    }
+    async start() {
+        if (!existsSync(this.file))
+            throw new Error("The PhreshOS System service is not registered");
+        await this.require(["--user", "start", unit]);
+    }
+    async stop() {
+        const state = await this.run(command, ["--user", "is-active", "--quiet", unit]);
+        if (state.code === 0)
+            await this.require(["--user", "stop", unit]);
+    }
+    async enable() {
+        if (!existsSync(this.file))
+            throw new Error("The PhreshOS System service is not registered");
+        await this.require(["--user", "enable", unit]);
+    }
+    async disable() {
+        if (!existsSync(this.file))
+            throw new Error("The PhreshOS System service is not registered");
+        await this.require(["--user", "disable", unit]);
+    }
+    async require(args) {
+        const result = await this.run(command, args);
+        if (result.code !== 0)
+            throw new Error(result.stderr.trim() || result.stdout.trim() || `${command} exited with code ${result.code}`);
+    }
+}
+function service(definition) {
+    return `[Unit]
+Description=PhreshOS System
+
+[Service]
+Type=simple
+ExecStart=${quote(definition.executable)} ${quote(definition.entry)}
+WorkingDirectory=${setting(definition.directory)}
+Restart=on-failure
+RestartSec=2
+StandardOutput=append:${setting(definition.output)}
+StandardError=append:${setting(definition.output)}
+
+[Install]
+WantedBy=default.target
+`;
+}
+function quote(value) {
+    return JSON.stringify(value);
+}
+function setting(value) {
+    if (value.includes("\n") || value.includes("\r"))
+        throw new Error("A systemd service path cannot contain a line break");
+    return value.replaceAll("%", "%%");
+}

package/dist/system/service/macos.js

@@ -0,0 +1,123 @@
+import { execute } from "../process.js";
+import { existsSync } from "node:fs";
+import { mkdir, rename, rm, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { randomUUID } from "node:crypto";
+const command = "/bin/launchctl";
+const defaultLabel = "com.phreshos.system";
+export default class MacOSSystemService {
+    run;
+    label;
+    plist;
+    domain;
+    target;
+    constructor(userHome, run = execute, label = defaultLabel) {
+        this.run = run;
+        this.label = label;
+        const uid = process.getuid?.();
+        if (uid === undefined)
+            throw new Error("The current macOS user could not be identified");
+        this.plist = join(userHome, "Library", "LaunchAgents", `${this.label}.plist`);
+        this.domain = `gui/${uid}`;
+        this.target = `${this.domain}/${this.label}`;
+    }
+    async inspect() {
+        const registered = existsSync(this.plist);
+        const service = await this.run(command, ["print", this.target]);
+        const disabled = await this.run(command, ["print-disabled", this.domain]);
+        const explicitlyDisabled = new RegExp(`"${escapePattern(this.label)}"\\s*=>\\s*(?:true|disabled)`).test(disabled.stdout);
+        const pid = /\bpid\s*=\s*(\d+)/.exec(service.stdout)?.[1];
+        return {
+            registered,
+            enabled: registered && !explicitlyDisabled,
+            running: service.code === 0 && /\bstate\s*=\s*running\b/.test(service.stdout),
+            ...(pid ? { pid: Number(pid) } : {})
+        };
+    }
+    async register(definition) {
+        await this.stop();
+        await mkdir(dirname(this.plist), { recursive: true });
+        await mkdir(dirname(definition.output), { recursive: true });
+        const temporary = `${this.plist}.${randomUUID()}.tmp`;
+        try {
+            await writeFile(temporary, plist(this.label, definition), { mode: 0o600 });
+            await rename(temporary, this.plist);
+        }
+        finally {
+            await rm(temporary, { force: true });
+        }
+    }
+    async unregister() {
+        await this.stop();
+        await rm(this.plist, { force: true });
+    }
+    async start() {
+        if (!existsSync(this.plist))
+            throw new Error("The PhreshOS System service is not registered");
+        const state = await this.inspect();
+        if (state.running)
+            return;
+        const loaded = await this.run(command, ["print", this.target]);
+        if (loaded.code === 0)
+            await this.require(["kickstart", "-k", this.target]);
+        else
+            await this.require(["bootstrap", this.domain, this.plist]);
+    }
+    async stop() {
+        const loaded = await this.run(command, ["print", this.target]);
+        if (loaded.code === 0)
+            await this.require(["bootout", this.target]);
+    }
+    async enable() {
+        if (!existsSync(this.plist))
+            throw new Error("The PhreshOS System service is not registered");
+        await this.require(["enable", this.target]);
+    }
+    async disable() {
+        if (!existsSync(this.plist))
+            throw new Error("The PhreshOS System service is not registered");
+        await this.require(["disable", this.target]);
+    }
+    async require(args) {
+        const result = await this.run(command, args);
+        if (result.code !== 0)
+            throw new Error(result.stderr.trim() || result.stdout.trim() || `${command} exited with code ${result.code}`);
+    }
+}
+function plist(label, definition) {
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>${xml(label)}</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>${xml(definition.executable)}</string>
+        <string>${xml(definition.entry)}</string>
+    </array>
+    <key>WorkingDirectory</key>
+    <string>${xml(definition.directory)}</string>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>KeepAlive</key>
+    <dict>
+        <key>SuccessfulExit</key>
+        <false/>
+    </dict>
+    <key>ThrottleInterval</key>
+    <integer>2</integer>
+    <key>StandardOutPath</key>
+    <string>${xml(definition.output)}</string>
+    <key>StandardErrorPath</key>
+    <string>${xml(definition.output)}</string>
+</dict>
+</plist>
+`;
+}
+function xml(value) {
+    return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;");
+}
+function escapePattern(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}

package/dist/template/package.json

@@ -16,7 +16,7 @@
         "react-dom": "^19.2.8"
     },
     "devDependencies": {
-        "@phreshos/cli": "^0.1.5",
+        "@phreshos/cli": "^0.1.7",
         "@types/node": "^26.2.0",
         "@types/react": "^19.2.18",
         "@types/react-dom": "^19.2.4",

package/package.json

@@ -1,12 +1,20 @@
 {
     "name": "@phreshos/cli",
     "type": "module",
-    "version": "0.1.5",
+    "version": "0.1.7",
     "description": "The Phresh command-line interface for Program projects and system management.",
+    "engines": {
+        "node": ">=20.10"
+    },
     "scripts": {
         "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
         "compile": "tsc --noEmit false --outDir dist --rootDir source --rewriteRelativeImportExtensions true --allowImportingTsExtensions true",
         "build": "node --run clean && node --run compile && node dist/build-template.js",
+        "test": "node --run compile && node --test tests/*.test.mjs",
+        "verify": "node --run build && node --run test && node scripts/verify-package.mjs",
+        "verify:system-release": "node --run compile && node scripts/verify-system-release.mjs",
+        "verify:linux-service": "node --run compile && node scripts/verify-linux-service.mjs",
+        "verify:macos-service": "node --run compile && node scripts/verify-macos-service.mjs",
         "prepack": "node --run build"
     },
     "bin": {
@@ -14,8 +22,29 @@
     },
     "files": [
         "dist",
+        "LICENSE",
         "README.md"
     ],
+    "author": "Zohayr SLILEH",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/PhreshOS/cli.git"
+    },
+    "bugs": {
+        "url": "https://github.com/PhreshOS/cli/issues"
+    },
+    "homepage": "https://github.com/PhreshOS/cli#readme",
+    "keywords": [
+        "phreshos",
+        "cli",
+        "program"
+    ],
+    "publishConfig": {
+        "access": "public",
+        "provenance": true
+    },
+    "packageManager": "bun@1.3.14",
     "dependencies": {
         "@clack/prompts": "^1.7.0",
         "@phreshos/core": "^0.1.1",