@vincenthanxiaodu/pi-web 1.202608.1

package/dist/nativeServices/serviceAction.js

@@ -0,0 +1,174 @@
+export const serviceStartOrder = ["sessiond", "web", "uiDev"];
+export const serviceStopOrder = ["web", "uiDev", "sessiond"];
+// Restart web/UI before sessiond: when `pi-web restart` runs in a pi-web
+// terminal (owned by sessiond), restarting sessiond kills the command, so any
+// services handled after it would never be restarted.
+export const serviceRestartOrder = ["web", "uiDev", "sessiond"];
+const LAUNCHD_UNLOAD_SETTLE_TIMEOUT_MS = 10_000;
+const LAUNCHD_UNLOAD_SETTLE_INTERVAL_MS = 250;
+const SERVICE_READINESS_TIMEOUT_MS = 30_000;
+const SERVICE_READINESS_INTERVAL_MS = 1_000;
+/** A service-manager command exited nonzero; carries the exact invocation for diagnosis. */
+export class ServiceCommandError extends Error {
+    constructor(command, args, status) {
+        super(`\`${command} ${args.join(" ")}\` failed with exit status ${String(status)}.`);
+        this.name = "ServiceCommandError";
+        this.command = command;
+        this.args = args;
+        this.status = status;
+    }
+}
+export function systemctlUserActionArgs(action, unitNames) {
+    return ["--user", action, ...unitNames];
+}
+export function launchdBootoutArgs(target) {
+    return ["bootout", target];
+}
+export function launchdPrintArgs(target) {
+    return ["print", target];
+}
+export function launchdBootstrapArgs(domain, plistPath) {
+    return ["bootstrap", domain, plistPath];
+}
+export function launchdEnableArgs(target) {
+    return ["enable", target];
+}
+export function launchdKickstartArgs(target) {
+    return ["kickstart", target];
+}
+export function launchdServiceTarget(domain, ref) {
+    return `${domain}/${ref.launchdLabel}`;
+}
+/** Order refs by service id, dropping ids that are not present. */
+export function orderServices(refs, order) {
+    const byId = new Map(refs.map((ref) => [ref.id, ref]));
+    return order.flatMap((id) => {
+        const ref = byId.get(id);
+        return ref === undefined ? [] : [ref];
+    });
+}
+function orderForAction(action) {
+    if (action === "stop")
+        return serviceStopOrder;
+    if (action === "restart")
+        return serviceRestartOrder;
+    return serviceStartOrder;
+}
+/**
+ * The running component a service must make responsive: the API-serving
+ * services (production web, development UI/API) back the web component; the
+ * session daemon backs itself.
+ */
+export function readinessComponentForService(id) {
+    return id === "sessiond" ? "sessiond" : "web";
+}
+function runChecked(deps, command, args) {
+    const status = deps.run(command, args);
+    if (status !== 0)
+        throw new ServiceCommandError(command, args, status);
+}
+function launchdServiceLoaded(target, deps) {
+    return deps.runQuiet("launchctl", launchdPrintArgs(target)) === 0;
+}
+/**
+ * Wait until launchd has fully unloaded a service after bootout. `launchctl
+ * bootout` only requests teardown: the label keeps resolving while launchd
+ * unloads asynchronously, and acting on the still-loaded record races the
+ * unload (a kickstart can succeed against the dying record just before the
+ * label disappears for good). A label that was never loaded settles
+ * immediately. Returns false when the label is still loaded after the
+ * timeout; the caller then falls back to the checked kickstart path, which
+ * keeps the outcome truthful instead of silently losing the service.
+ */
+export async function settleLaunchdServiceUnload(target, deps, timing = {}) {
+    const timeoutMs = timing.launchdUnloadSettleTimeoutMs ?? LAUNCHD_UNLOAD_SETTLE_TIMEOUT_MS;
+    const intervalMs = timing.launchdUnloadSettleIntervalMs ?? LAUNCHD_UNLOAD_SETTLE_INTERVAL_MS;
+    const maxPolls = Math.max(1, Math.ceil(timeoutMs / intervalMs));
+    for (let poll = 0; poll < maxPolls; poll += 1) {
+        if (!launchdServiceLoaded(target, deps))
+            return true;
+        await deps.sleep(intervalMs);
+    }
+    return !launchdServiceLoaded(target, deps);
+}
+/**
+ * Start (or kick) one LaunchAgent: bootstrap and enable only when the label
+ * is not loaded, then kickstart. Any manager failure throws ServiceCommandError.
+ */
+export function startLaunchdService(ref, context, deps) {
+    const target = launchdServiceTarget(context.domain, ref);
+    if (!launchdServiceLoaded(target, deps)) {
+        runChecked(deps, "launchctl", launchdBootstrapArgs(context.domain, context.plistPath(ref)));
+        runChecked(deps, "launchctl", launchdEnableArgs(target));
+    }
+    runChecked(deps, "launchctl", launchdKickstartArgs(target));
+}
+/**
+ * Restart one LaunchAgent without racing launchd's asynchronous unload:
+ * bootout, wait for the label to disappear, then start. A settle timeout
+ * falls through to the start path, whose kickstart is checked, so a stuck
+ * unload surfaces as a failure instead of an exit-0-while-gone restart.
+ */
+export async function restartLaunchdService(ref, context, deps, timing = {}) {
+    const target = launchdServiceTarget(context.domain, ref);
+    deps.runQuiet("launchctl", launchdBootoutArgs(target));
+    await settleLaunchdServiceUnload(target, deps, timing);
+    startLaunchdService(ref, context, deps);
+}
+/**
+ * Wait until every service is manager-reported running and its user-facing
+ * component responds. Manager state gates the component probe: a service that
+ * is not running yet is not probed. Returns the services still unready when
+ * the bounded wait expires.
+ */
+export async function awaitServicesReady(refs, deps, timing = {}) {
+    const timeoutMs = timing.readinessTimeoutMs ?? SERVICE_READINESS_TIMEOUT_MS;
+    const intervalMs = timing.readinessIntervalMs ?? SERVICE_READINESS_INTERVAL_MS;
+    const maxPolls = Math.max(1, Math.ceil(timeoutMs / intervalMs));
+    const pending = new Set(refs);
+    for (let poll = 0; poll < maxPolls && pending.size > 0; poll += 1) {
+        for (const ref of [...pending]) {
+            if (!deps.isServiceRunning(ref))
+                continue;
+            if (await deps.isComponentReady(readinessComponentForService(ref.id)))
+                pending.delete(ref);
+        }
+        if (pending.size > 0)
+            await deps.sleep(intervalMs);
+    }
+    return [...pending];
+}
+/**
+ * Perform a start/stop/restart against the native service manager, then — for
+ * start and restart — verify that each affected service actually becomes
+ * ready. systemd restarts are a single synchronous manager job; launchd
+ * restarts settle each asynchronous bootout before the bootstrap-vs-kickstart
+ * decision. The readiness gate is what makes exit-0-while-not-serving
+ * impossible on both backends.
+ */
+export async function performServiceAction(input, deps, timing = {}) {
+    const refs = orderServices(input.refs, orderForAction(input.action));
+    if (refs.length === 0)
+        return { unreadyServices: [] };
+    if (input.backend.kind === "systemd") {
+        runChecked(deps, "systemctl", systemctlUserActionArgs(input.action, refs.map((ref) => ref.systemdName)));
+    }
+    else if (input.action === "stop") {
+        for (const ref of refs)
+            deps.runQuiet("launchctl", launchdBootoutArgs(launchdServiceTarget(input.launchdContext.domain, ref)));
+    }
+    else if (input.action === "restart") {
+        // Restart each service fully (bootout + settle + start) before moving to
+        // the next, so the web/UI services are back up before sessiond is restarted.
+        for (const ref of refs)
+            await restartLaunchdService(ref, input.launchdContext, deps, timing);
+    }
+    else {
+        for (const ref of refs)
+            startLaunchdService(ref, input.launchdContext, deps);
+    }
+    if (input.action === "stop")
+        return { unreadyServices: [] };
+    return { unreadyServices: await awaitServicesReady(refs, deps, timing) };
+}
+//# sourceMappingURL=serviceAction.js.map

package/dist/nativeServices/serviceAction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serviceAction.js","sourceRoot":"","sources":["../../src/nativeServices/serviceAction.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,MAAM,iBAAiB,GAA+B,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AAC1F,MAAM,CAAC,MAAM,gBAAgB,GAA+B,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;AACzF,yEAAyE;AACzE,8EAA8E;AAC9E,sDAAsD;AACtD,MAAM,CAAC,MAAM,mBAAmB,GAA+B,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;AAE5F,MAAM,gCAAgC,GAAG,MAAM,CAAC;AAChD,MAAM,iCAAiC,GAAG,GAAG,CAAC;AAC9C,MAAM,4BAA4B,GAAG,MAAM,CAAC;AAC5C,MAAM,6BAA6B,GAAG,KAAK,CAAC;AAmC5C,4FAA4F;AAC5F,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAK5C,YAAY,OAAe,EAAE,IAAuB,EAAE,MAAc;QAClE,KAAK,CAAC,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,8BAA8B,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACrF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,UAAU,uBAAuB,CAAC,MAA8B,EAAE,SAA4B;IAClG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAc,EAAE,SAAiB;IACpE,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAc,EAAE,GAAwB;IAC3E,OAAO,GAAG,MAAM,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;AACzC,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,aAAa,CAAgC,IAAkB,EAAE,KAAiC;IAChH,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACvD,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzB,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,cAAc,CAAC,MAA8B;IACpD,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,gBAAgB,CAAC;IAC/C,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,mBAAmB,CAAC;IACrD,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAAC,EAAmB;IAC9D,OAAO,EAAE,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC;AAChD,CAAC;AAED,SAAS,UAAU,CAAC,IAAoC,EAAE,OAAe,EAAE,IAAc;IACvF,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACvC,IAAI,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,mBAAmB,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AACzE,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAc,EAAE,IAAyC;IACrF,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;AACpE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,MAAc,EACd,IAAmD,EACnD,SAA8B,EAAE;IAEhC,MAAM,SAAS,GAAG,MAAM,CAAC,4BAA4B,IAAI,gCAAgC,CAAC;IAC1F,MAAM,UAAU,GAAG,MAAM,CAAC,6BAA6B,IAAI,iCAAiC,CAAC;IAC7F,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC;IAChE,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,QAAQ,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QAC9C,IAAI,CAAC,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACrD,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,CAAC,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAAwB,EACxB,OAA8B,EAC9B,IAAiD;IAEjD,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACzD,IAAI,CAAC,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;QACxC,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,oBAAoB,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC5F,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3D,CAAC;IACD,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,GAAwB,EACxB,OAA8B,EAC9B,IAA2D,EAC3D,SAA8B,EAAE;IAEhC,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACzD,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;IACvD,MAAM,0BAA0B,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACvD,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAoC,EACpC,IAAgF,EAChF,SAA8B,EAAE;IAEhC,MAAM,SAAS,GAAG,MAAM,CAAC,kBAAkB,IAAI,4BAA4B,CAAC;IAC5E,MAAM,UAAU,GAAG,MAAM,CAAC,mBAAmB,IAAI,6BAA6B,CAAC;IAC/E,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,QAAQ,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QAClE,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC1C,IAAI,MAAM,IAAI,CAAC,gBAAgB,CAAC,4BAA4B,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7F,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC;YAAE,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC;AACtB,CAAC;AAcD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAyB,EACzB,IAAuB,EACvB,SAA8B,EAAE;IAEhC,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACrE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC;IAEtD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACrC,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,uBAAuB,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAC3G,CAAC;SAAM,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QACnC,KAAK,MAAM,GAAG,IAAI,IAAI;YAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC,oBAAoB,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACjI,CAAC;SAAM,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACtC,yEAAyE;QACzE,6EAA6E;QAC7E,KAAK,MAAM,GAAG,IAAI,IAAI;YAAE,MAAM,qBAAqB,CAAC,GAAG,EAAE,KAAK,CAAC,cAAc,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC/F,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,GAAG,IAAI,IAAI;YAAE,mBAAmB,CAAC,GAAG,EAAE,KAAK,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;IAC/E,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC;IAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;AAC3E,CAAC"}