@adecore/service 0.21.1 → 0.22.0

package/README.md

@@ -1,6 +1,6 @@
 # @adecore/service
 
-Definitions and injectable managers for macOS launchd GUI jobs and Linux systemd user services. The host supplies identity, paths, environment, commands and files. It keeps installation authorization and executable policy.
+Definitions and managers for macOS launchd GUI jobs and Linux systemd user services, with everything they touch injected. The host supplies the identity, paths, environment, commands and files. Deciding who may install a service and which executable it runs stays with the host.
 
 ```sh
 bun add @adecore/service
@@ -23,8 +23,8 @@ const spec: ServiceSpec = {
 const definition = systemdUnit(spec);
 ```
 
-`/definitions` has no Node or Bun runtime imports. The root, `/manager`, `/platform` and `/system` are backend entrypoints. Importing them does not install or start a service.
+`/definitions` imports nothing from Node or Bun. The root, `/manager`, `/platform` and `/system` are for a backend, and importing them installs or starts nothing.
 
-`install()` returns whether an existing definition changed, so a first install returns `false`. Await `restart()` for a changed definition, otherwise call `start()`. Uninstall does not stop a running job. Managers supply no authorization, lock, cancellation or automatic lingering.
+`install()` returns whether an existing definition changed, so a first install returns `false`. Await `restart()` after a change, and call `start()` otherwise. Uninstalling does not stop a running job. The managers bring no authorization, lock, cancellation or automatic lingering.
 
-The full documentation covers the [overview](https://adecore.dev/service/), [definitions](https://adecore.dev/service/definitions) and [managers](https://adecore.dev/service/managers), with a test that uses fakes instead of real service commands.
+The documentation has an [overview](https://adecore.dev/service/), [definitions](https://adecore.dev/service/definitions) and [managers](https://adecore.dev/service/managers), including a test that runs on fakes instead of the real service commands.

package/dist/manager.js

@@ -1,10 +1,7 @@
 import { dirname, join } from 'node:path';
-function describe(result, what) {
-    return `${what} failed (${result.code}): ${(result.stderr || result.stdout).trim() || 'no output'}`;
-}
 function expectSuccess(result, what) {
     if (result.code !== 0) {
-        throw new Error(describe(result, what));
+        throw new Error(`${what} failed (${result.code}): ${(result.stderr || result.stdout).trim() || 'no output'}`);
     }
 }
 /*
@@ -13,10 +10,9 @@ function expectSuccess(result, what) {
  * the bundle, where the login shell's PATH and a log path in the home cannot be written.
  */
 export function launchdManager(options) {
-    const label = options.label;
-    const path = join(options.home, 'Library', 'LaunchAgents', `${label}.plist`);
+    const path = join(options.home, 'Library', 'LaunchAgents', `${options.label}.plist`);
     const domain = `gui/${options.uid}`;
-    const target = `${domain}/${label}`;
+    const target = `${domain}/${options.label}`;
     const launchctl = (...args) => options.run('/bin/launchctl', args);
     const isLoaded = () => launchctl('print', target).code === 0;
     const bootstrap = () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adecore/service",
-  "version": "0.21.1",
+  "version": "0.22.0",
   "description": "User service definitions and injectable launchd and systemd managers.",
   "license": "FSL-1.1-MIT",
   "author": "Bas Milius",

package/src/manager.ts

@@ -19,7 +19,7 @@ export interface ServiceFiles {
 
 export interface ServiceManager {
     readonly kind: 'launchd' | 'systemd';
-    /* Where the definition lives, for the documentation and the error a person reads. */
+    /* The definition's file. */
     readonly path: string;
     isInstalled(): boolean;
     /* The definition on disk, null when there is none. */
@@ -41,13 +41,9 @@ export interface ServiceManager {
     linger?: { enabled(): boolean; enable(): void };
 }
 
-function describe(result: CommandResult, what: string): string {
-    return `${what} failed (${result.code}): ${(result.stderr || result.stdout).trim() || 'no output'}`;
-}
-
 function expectSuccess(result: CommandResult, what: string): void {
     if (result.code !== 0) {
-        throw new Error(describe(result, what));
+        throw new Error(`${what} failed (${result.code}): ${(result.stderr || result.stdout).trim() || 'no output'}`);
     }
 }
 
@@ -67,10 +63,9 @@ export interface LaunchdOptions {
  * the bundle, where the login shell's PATH and a log path in the home cannot be written.
  */
 export function launchdManager(options: LaunchdOptions): ServiceManager {
-    const label = options.label;
-    const path = join(options.home, 'Library', 'LaunchAgents', `${label}.plist`);
+    const path = join(options.home, 'Library', 'LaunchAgents', `${options.label}.plist`);
     const domain = `gui/${options.uid}`;
-    const target = `${domain}/${label}`;
+    const target = `${domain}/${options.label}`;
     const launchctl = (...args: string[]): CommandResult => options.run('/bin/launchctl', args);
     const isLoaded = (): boolean => launchctl('print', target).code === 0;