@bytetrue/byspace 0.14.6 → 0.16.0

package/dist/commands/daemon/service/windows-task.js

@@ -0,0 +1,75 @@
+import { spawnSync } from "node:child_process";
+/**
+ * Windows scheduling backend. There is no launchd-style responsible-process Local
+ * Network gate on Windows; the value here is start-at-login plus crash recovery,
+ * not a bug fix — copy must not imply otherwise.
+ *
+ * The task runs `node.exe <runner-entry>` directly, never the `byspace.cmd` shim:
+ * the shim goes through cmd.exe, which adds parsing layers scheduled tasks handle
+ * poorly and hides the exit path.
+ */
+const TASK_FOLDER = "BySpace";
+/** The scheduled task name for the daemon (folder-qualified for the API surface). */
+export function scheduledTaskName(label) {
+    return `${TASK_FOLDER}\\${label}`;
+}
+/** Build the Register-ScheduledTask argument vector. Exposed for tests. */
+export function buildRegisterArgs(spec) {
+    const action = `$action = New-ScheduledTaskAction -Execute '${spec.nodePath}' -Argument '${spec.runnerEntry} ${escapeArgs(spec.runnerArgs)}'`;
+    const trigger = "$trigger = New-ScheduledTaskTrigger -AtLogOn";
+    const settings = "$settings = New-ScheduledTaskSettingsSet -RestartCount 3 -RestartInterval (New-TimeSpan -Minutes 1) -StartWhenAvailable -ExecutionTimeLimit ([TimeSpan]::Zero)";
+    const principal = "$principal = New-ScheduledTaskPrincipal -UserId ([System.Security.Principal.WindowsIdentity]::GetCurrent().Name) -LogonType Interactive";
+    const register = `Register-ScheduledTask -TaskPath '\\${TASK_FOLDER}\\' -TaskName '${spec.label}' -Action $action -Trigger $trigger -Settings $settings -Principal $principal -Force | Out-Null`;
+    const envBlock = Object.entries(spec.env)
+        .map(([key, value]) => `[Environment]::SetEnvironmentVariable('${key}', '${escapePowerShell(value)}', 'Process')`)
+        .join("; ");
+    const envSetup = envBlock ? `${envBlock}; ` : "";
+    return [
+        "-NoProfile",
+        "-NonInteractive",
+        "-Command",
+        `${action}; ${trigger}; ${settings}; ${principal}; ${envSetup}${register}`,
+    ];
+}
+function escapeArgs(args) {
+    return args.map((arg) => arg.replace(/'/g, "''")).join(" ");
+}
+function escapePowerShell(value) {
+    return value.replace(/'/g, "''");
+}
+function powershell(args) {
+    const result = spawnSync("powershell.exe", args, { encoding: "utf8", timeout: 30000 });
+    const output = `${result.stdout ?? ""}${result.stderr ?? ""}`.trim();
+    return { ok: result.status === 0, output };
+}
+/** Register the scheduled task. Env vars are snapshotted into the task definition. */
+export function installWindowsTask(spec) {
+    const result = powershell(buildRegisterArgs(spec));
+    if (!result.ok) {
+        throw new Error(`Register-ScheduledTask failed: ${result.output}`);
+    }
+}
+/** Unregister the task. Idempotent: succeeds when nothing is registered. */
+export function uninstallWindowsTask(label) {
+    powershell([
+        "-NoProfile",
+        "-NonInteractive",
+        "-Command",
+        `Unregister-ScheduledTask -TaskPath '\\${TASK_FOLDER}\\' -TaskName '${label}' -Confirm:$false -ErrorAction SilentlyContinue`,
+    ]);
+}
+/** The pid of the daemon process the task last launched, via task state. */
+export function windowsTaskPid(label) {
+    const result = powershell([
+        "-NoProfile",
+        "-NonInteractive",
+        "-Command",
+        `(Get-ScheduledTask -TaskPath '\\${TASK_FOLDER}\\' -TaskName '${label}' -ErrorAction SilentlyContinue | Get-ScheduledTaskInfo).LastTaskResult`,
+    ]);
+    if (!result.ok)
+        return null;
+    // 0 = last run succeeded; the task itself does not hold a pid, so the daemon pid
+    // is resolved by the caller from the pid file, not from Task Scheduler.
+    return result.output.includes("0") ? 0 : null;
+}
+//# sourceMappingURL=windows-task.js.map

package/dist/commands/daemon/service-status.d.ts

@@ -0,0 +1,13 @@
+import type { Command } from "commander";
+import type { CommandOptions, SingleResult } from "../../output/index.js";
+interface ServiceStatusResult {
+    state: string;
+    label: string;
+    servicePid: string;
+    daemonPid: string;
+    managedByThisProcess: string;
+}
+export type ServiceStatusCommandResult = SingleResult<ServiceStatusResult>;
+export declare function runServiceStatusCommand(options: CommandOptions, _command: Command): Promise<ServiceStatusCommandResult>;
+export {};
+//# sourceMappingURL=service-status.d.ts.map

package/dist/commands/daemon/service-status.js

@@ -0,0 +1,30 @@
+import { resolveLaunchdServiceStatus } from "./service/service-status.js";
+import { resolveLocalDaemonState } from "./local-daemon.js";
+const serviceStatusResultSchema = {
+    idField: "state",
+    columns: [
+        { header: "STATE", field: "state" },
+        { header: "LABEL", field: "label" },
+        { header: "SERVICE PID", field: "servicePid" },
+        { header: "DAEMON PID", field: "daemonPid" },
+        { header: "MANAGED", field: "managedByThisProcess" },
+    ],
+};
+const SERVICE_LABEL = "cc.cd.byspace.daemon";
+export async function runServiceStatusCommand(options, _command) {
+    const home = typeof options.home === "string" ? options.home : undefined;
+    const state = resolveLocalDaemonState({ home });
+    const status = resolveLaunchdServiceStatus(SERVICE_LABEL, state.home, state.pidInfo?.pid ?? null);
+    return {
+        type: "single",
+        data: {
+            state: status.state,
+            label: status.label,
+            servicePid: status.servicePid === null ? "-" : String(status.servicePid),
+            daemonPid: status.currentPid === null ? "-" : String(status.currentPid),
+            managedByThisProcess: status.state === "managed-by-service" ? "yes" : "no",
+        },
+        schema: serviceStatusResultSchema,
+    };
+}
+//# sourceMappingURL=service-status.js.map

package/dist/commands/daemon/uninstall-service.d.ts

@@ -0,0 +1,11 @@
+import type { Command } from "commander";
+import type { CommandOptions, SingleResult } from "../../output/index.js";
+interface UninstallServiceResult {
+    action: "uninstalled" | "not_installed";
+    label: string;
+    message: string;
+}
+export type UninstallServiceCommandResult = SingleResult<UninstallServiceResult>;
+export declare function runUninstallServiceCommand(options: CommandOptions, _command: Command): Promise<UninstallServiceCommandResult>;
+export {};
+//# sourceMappingURL=uninstall-service.d.ts.map

package/dist/commands/daemon/uninstall-service.js

@@ -0,0 +1,53 @@
+import { uninstallLaunchdService } from "./service/launchd.js";
+import { resolveLaunchdServiceStatus } from "./service/service-status.js";
+import { resolveLocalDaemonState } from "./local-daemon.js";
+const uninstallServiceResultSchema = {
+    idField: "action",
+    columns: [
+        {
+            header: "STATUS",
+            field: "action",
+            color: (value) => (value === "uninstalled" ? "green" : "yellow"),
+        },
+        { header: "LABEL", field: "label" },
+        { header: "MESSAGE", field: "message" },
+    ],
+};
+const SERVICE_LABEL = "cc.cd.byspace.daemon";
+export async function runUninstallServiceCommand(options, _command) {
+    const home = typeof options.home === "string" ? options.home : undefined;
+    const state = resolveLocalDaemonState({ home });
+    try {
+        const status = resolveLaunchdServiceStatus(SERVICE_LABEL, state.home, state.pidInfo?.pid ?? null);
+        if (status.state === "not-installed") {
+            return {
+                type: "single",
+                data: {
+                    action: "not_installed",
+                    label: SERVICE_LABEL,
+                    message: "No daemon service is registered for this user.",
+                },
+                schema: uninstallServiceResultSchema,
+            };
+        }
+        uninstallLaunchdService(SERVICE_LABEL, state.home);
+        return {
+            type: "single",
+            data: {
+                action: "uninstalled",
+                label: SERVICE_LABEL,
+                message: "The daemon service was unregistered and will no longer start at login.",
+            },
+            schema: uninstallServiceResultSchema,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const error = {
+            code: "UNINSTALL_SERVICE_FAILED",
+            message: `Failed to uninstall the daemon service: ${message}`,
+        };
+        throw error;
+    }
+}
+//# sourceMappingURL=uninstall-service.js.map

package/node_modules/@bytetrue/client/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bytetrue/client",
-  "version": "0.14.6",
+  "version": "0.16.0",
   "description": "BySpace client SDK package",
   "files": [
     "dist",
@@ -39,8 +39,8 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@bytetrue/protocol": "0.14.6",
-    "@bytetrue/relay": "0.14.6"
+    "@bytetrue/protocol": "0.16.0",
+    "@bytetrue/relay": "0.16.0"
   },
   "devDependencies": {
     "@types/node": "^20.9.0",

package/node_modules/@bytetrue/highlight/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bytetrue/highlight",
-  "version": "0.14.6",
+  "version": "0.16.0",
   "files": [
     "dist",
     "!dist/**/*.map",