@usine/server 0.3.0 → 0.4.0

package/dist/registry.js

@@ -0,0 +1,37 @@
+import { Effect, Schema } from "effect";
+import { runCommand } from "./command.js";
+const NPM_VIEW_TIMEOUT = "30 seconds";
+/** The registry has no version of the package that matches the spec, or npm couldn't ask it. */
+export class PackageLookupError extends Schema.TaggedError("@usine/server/PackageLookupError")("PackageLookupError", {
+    name: Schema.String,
+    spec: Schema.String,
+    reason: Schema.String,
+}) {
+}
+const Versions = Schema.fromJsonString(Schema.Union([Schema.String, Schema.Array(Schema.String)]));
+const Dependencies = Schema.fromJsonString(Schema.Record(Schema.String, Schema.String));
+/** Runs `npm view <name>@<spec> <field> --json` in `directory`, so its `.npmrc` applies. */
+const npmView = (directory, name, spec, field) => runCommand("npm", ["view", `${name}@${spec}`, field, "--json"], directory, NPM_VIEW_TIMEOUT).pipe(Effect.map(({ stdout }) => stdout.trim()), Effect.mapError((error) => new PackageLookupError({ name, spec, reason: error.reason })));
+/**
+ * Returns the version that `spec`, a version, range, or dist-tag, resolves to on the registry: the
+ * highest one for a range.
+ */
+export const resolveVersion = Effect.fn("Registry.resolveVersion")(function* (directory, name, spec) {
+    yield* Effect.annotateCurrentSpan({ name, spec });
+    const output = yield* npmView(directory, name, spec, "version");
+    const decoded = yield* Schema.decodeUnknownEffect(Versions)(output).pipe(Effect.mapError(() => new PackageLookupError({ name, spec, reason: "no published version matches" })));
+    const versions = Schema.is(Schema.String)(decoded) ? [decoded] : decoded;
+    const version = versions.at(-1);
+    if (version === undefined) {
+        return yield* new PackageLookupError({ name, spec, reason: "no published version matches" });
+    }
+    return version;
+});
+/** Returns the published dependencies of `name@version`, with their version specs. */
+export const dependenciesOf = Effect.fn("Registry.dependenciesOf")(function* (directory, name, version) {
+    const output = yield* npmView(directory, name, version, "dependencies");
+    if (output === "")
+        return {};
+    return yield* Schema.decodeUnknownEffect(Dependencies)(output).pipe(Effect.mapError((error) => new PackageLookupError({ name, spec: version, reason: error.message })));
+});
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/restart.d.ts

@@ -0,0 +1,19 @@
+import { Effect } from "effect";
+import { type CliEnvironment, type CliUsageError, type LifecycleOptions } from "./cli.ts";
+import { type InstanceLaunch } from "./instance/record.ts";
+import { InstanceNotRunningError, UnrecordedInstanceError } from "./stop.ts";
+/**
+ * Returns the launch of a `usine up --detach` without flags from this CLI, which `usine restart`
+ * starts for an instance without a readable record.
+ */
+export declare const fallbackLaunch: (environment: CliEnvironment) => Effect.Effect<InstanceLaunch, CliUsageError, never>;
+/**
+ * Stops the `usine up` of the instance folder and starts it again in the background, with the
+ * Node.js binary, entry point, port, and flags that it recorded, or with `systemctl` if a systemd
+ * service runs it. Without a readable record, as from a usine version that writes only
+ * `.usine/instance.pid`, stops the process in that file and starts `fallback`. The checks then ask
+ * the port on which that process answers, and pass if none does. Fails with `ListeningPortsError`,
+ * before any signal, if the OS can't list that process's ports.
+ */
+export declare const restart: (directory: string & import("effect/Brand").Brand<"InstanceDirectory">, options: LifecycleOptions, fallback: Effect.Effect<InstanceLaunch, CliUsageError, never>) => Effect.Effect<void, CliUsageError | import("./detach.ts").DetachedSpawnError | import("./detach.ts").DetachedStartError | import("./instance/lock.ts").InstanceLockError | InstanceNotRunningError | import("./stop.ts").KillTimeoutError | import("./instance/ports.ts").ListeningPortsError | import("./stop.ts").LiveAttemptsError | import("./stop.ts").MissingEnvironmentError | import("./instance/state.ts").SignalError | import("./stop.ts").StopTimeoutError | import("./instance/systemd.ts").SystemctlError | import("./detach.ts").SystemdStartError | UnrecordedInstanceError, import("effect/process/ChildProcessSpawner").ChildProcessSpawner | import("effect/FileSystem").FileSystem | import("effect/http/HttpClient").HttpClient>;
+//# sourceMappingURL=restart.d.ts.map

package/dist/restart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart.d.ts","sourceRoot":"","sources":["../src/restart.ts"],"names":[],"mappings":"AACA,OAAO,EAAW,MAAM,EAAU,MAAM,QAAQ,CAAC;AACjD,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EAEtB,MAAM,UAAU,CAAC;AAIlB,OAAO,EACL,KAAK,cAAc,EAIpB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EAIxB,MAAM,WAAW,CAAC;AAEnB;;;GAGG;AACH,eAAO,MAAM,cAAc,gBAAiB,cAAc,wDACM,CAAC;AA4FjE;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,43BAoBlB,CAAC"}

package/dist/restart.js

@@ -0,0 +1,105 @@
+import { Console, Effect, Option } from "effect";
+import { environmentUp, } from "./cli.js";
+import { startAgain, startedMessage } from "./detach.js";
+import { listRuns } from "./instance/operator-api.js";
+import { listeningPorts } from "./instance/ports.js";
+import { currentLaunch, } from "./instance/record.js";
+import { probeInstance } from "./instance/state.js";
+import { supervisingUnit } from "./instance/systemd.js";
+import { InstanceNotRunningError, UnrecordedInstanceError, refuseLiveAttempts, refuseMissingEnvironment, stopProcess, } from "./stop.js";
+/**
+ * Returns the launch of a `usine up --detach` without flags from this CLI, which `usine restart`
+ * starts for an instance without a readable record.
+ */
+export const fallbackLaunch = (environment) => environmentUp(environment).pipe(Effect.flatMap(currentLaunch));
+/**
+ * Returns the port on which the process answers the operator API, or `None` if none of its ports
+ * does. Fails if the OS can't list its ports.
+ */
+const operatorPort = Effect.fn("Cli.operatorPort")(function* (pid) {
+    const ports = yield* listeningPorts(pid);
+    const port = yield* Effect.findFirst(ports, (port) => listRuns(port).pipe(Effect.tapError((error) => Effect.logDebug("A port of the instance process doesn't answer the operator API", {
+        pid,
+        port,
+        reason: error.reason,
+    })), Effect.isSuccess));
+    yield* Effect.annotateCurrentSpan({ pid, ports, port: Option.getOrUndefined(port) });
+    return port;
+});
+/**
+ * Returns the process that `usine restart` stops, its record if readable, the systemd service that
+ * runs it, the port on which the checks ask it, and the next launch.
+ */
+const restartTarget = Effect.fn("Cli.restartTarget")(function* (directory, fallback) {
+    yield* Effect.annotateCurrentSpan({ instanceDirectory: directory });
+    const state = yield* probeInstance(directory);
+    if (state._tag === "Stopped") {
+        yield* Effect.logInfo("Refusing to restart: usine is not running in the instance folder", {
+            instanceDirectory: directory,
+        });
+        return yield* new InstanceNotRunningError({ command: "restart", directory });
+    }
+    if (state._tag === "Running") {
+        const { record } = state;
+        yield* Effect.annotateCurrentSpan({ pid: record.pid });
+        return {
+            pid: record.pid,
+            record: Option.some(record),
+            unit: yield* supervisingUnit(record.pid, record.systemdUnit),
+            port: Option.some(record.launch.port),
+            launch: record.launch,
+        };
+    }
+    if (Option.isNone(state.pid)) {
+        yield* Effect.logInfo("Refusing to restart: a process holds the instance lock, but the pid file names no running process", { instanceDirectory: directory });
+        return yield* new UnrecordedInstanceError({ command: "restart", directory, pid: state.pid });
+    }
+    const pid = state.pid.value;
+    yield* Effect.annotateCurrentSpan({ pid });
+    const launch = yield* fallback;
+    const port = yield* operatorPort(pid).pipe(Effect.tapError((error) => Effect.logWarning("Refusing to restart: the ports of the instance process are unknown", {
+        pid,
+        reason: error.reason,
+    })));
+    yield* Effect.logInfo("Restarting an instance without a readable record with this CLI's launch", {
+        pid,
+        port: Option.getOrUndefined(port),
+        launchPort: launch.port,
+        script: launch.script,
+    });
+    yield* Console.log(Option.match(port, {
+        onNone: () => `usine (pid ${pid}) runs without a readable .usine/instance.json and answers on no port, so usine restart can't check its running attempts or gateway variables. usine restart starts usine up as usine up --detach would, on port ${launch.port}.`,
+        onSome: (current) => `usine (pid ${pid}) runs without a readable .usine/instance.json and answers on port ${current}. usine restart checks it there, then starts usine up as usine up --detach would, on port ${launch.port}.`,
+    }));
+    return {
+        pid,
+        record: Option.none(),
+        unit: Option.none(),
+        port,
+        launch,
+    };
+});
+/**
+ * Stops the `usine up` of the instance folder and starts it again in the background, with the
+ * Node.js binary, entry point, port, and flags that it recorded, or with `systemctl` if a systemd
+ * service runs it. Without a readable record, as from a usine version that writes only
+ * `.usine/instance.pid`, stops the process in that file and starts `fallback`. The checks then ask
+ * the port on which that process answers, and pass if none does. Fails with `ListeningPortsError`,
+ * before any signal, if the OS can't list that process's ports.
+ */
+export const restart = Effect.fn("Cli.restart")(function* (directory, options, fallback) {
+    const { pid, record, unit, port, launch } = yield* restartTarget(directory, fallback);
+    if (Option.isSome(port)) {
+        yield* refuseMissingEnvironment("restart", port.value);
+        yield* refuseLiveAttempts("restart", port.value, options.force);
+    }
+    else {
+        yield* Effect.logWarning("Skipping the restart checks: the instance process answers on no port", {
+            pid,
+        });
+    }
+    yield* stopProcess("restart", pid, record, unit, options);
+    const started = yield* startAgain(directory, launch, unit, pid, options.timeout);
+    yield* Console.log(startedMessage(started));
+});
+//# sourceMappingURL=restart.js.map

package/dist/restart.js.map

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

package/dist/status.d.ts

@@ -0,0 +1,12 @@
+import { Effect } from "effect";
+/** What `usine status` prints, and whether a process holds the instance. */
+export interface StatusReport {
+    readonly running: boolean;
+    readonly lines: ReadonlyArray<string>;
+}
+/**
+ * Reads whether `usine up` runs in the instance folder, with one request to its operator API and,
+ * for an engine installed from a pin, one `npm view`.
+ */
+export declare const status: (directory: string & import("effect/Brand").Brand<"InstanceDirectory">) => Effect.Effect<StatusReport, import("./instance/lock.ts").InstanceLockError, import("effect/process/ChildProcessSpawner").ChildProcessSpawner | import("effect/FileSystem").FileSystem | import("effect/http/HttpClient").HttpClient>;
+//# sourceMappingURL=status.d.ts.map

package/dist/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,MAAM,EAAU,MAAM,QAAQ,CAAC;AAgB5D,4EAA4E;AAC5E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACvC;AA+ID;;;GAGG;AACH,eAAO,MAAM,MAAM,iTAGjB,CAAC"}

package/dist/status.js

@@ -0,0 +1,99 @@
+import { DateTime, Duration, Effect, Option } from "effect";
+import { SERVER_HOST, packageVersion } from "./cli.js";
+import { SERVER_PACKAGE, compareVersions, installedInInstance, readManifest, realPathOrSelf, serverPin, } from "./instance/manifest.js";
+import { listRuns } from "./instance/operator-api.js";
+import { probeInstance } from "./instance/state.js";
+import { supervisingUnit } from "./instance/systemd.js";
+import { resolveVersion } from "./registry.js";
+/** The Run states that count as open, in lifecycle order from the latest. */
+const OPEN_STATES = ["Running", "Queued", "Waiting", "Pending"];
+const ago = (since, now) => {
+    const seconds = Math.max(0, Math.floor(Duration.toSeconds(DateTime.distance(since, now))));
+    return `${seconds === 0 ? "0s" : Duration.format(Duration.seconds(seconds))} ago`;
+};
+const field = (label, value) => `  ${label.padEnd(10)}${value}`;
+/** Summarizes the open Runs by state, such as `2 running, 1 queued`. */
+const openRuns = (runs) => {
+    const counts = OPEN_STATES.map((state) => [state, runs.filter((run) => run.state === state).length]).filter(([, count]) => count > 0);
+    return counts.length === 0
+        ? "none open"
+        : counts.map(([state, count]) => `${count} ${state.toLowerCase()}`).join(", ");
+};
+/**
+ * Returns the service line for an instance whose systemd service has it as its main process, or
+ * `None` for an instance outside one.
+ */
+const serviceLine = (record) => supervisingUnit(record.pid, record.systemdUnit).pipe(Effect.map(Option.map((unit) => field("service", `${unit}, managed with systemctl`))), Effect.catchTag("SystemctlError", (error) => Effect.succeed(Option.some(field("service", `${error.unit}, unknown: ${error.reason}`)))));
+/** Returns the update line for an engine installed from a pin, or `None` for other engines. */
+const updateLine = Effect.fn("Cli.statusUpdate")(function* (directory, record, installed) {
+    if (!installed)
+        return Option.none();
+    const manifest = yield* readManifest(directory).pipe(Effect.tapError((error) => Effect.logWarning("Could not read the instance's package.json", {
+        path: error.path,
+        reason: error.reason,
+    })), Effect.orElseSucceed(() => Option.none()));
+    if (Option.isNone(Option.flatMap(manifest, serverPin)))
+        return Option.none();
+    return Option.some(yield* resolveVersion(directory, SERVER_PACKAGE, "latest").pipe(Effect.map((latest) => compareVersions(latest, record.version) > 0
+        ? field("update", `@usine/server ${latest} is available. Run usine upgrade.`)
+        : field("update", `none, ${record.version} is the latest release`)), Effect.catchTag("PackageLookupError", (error) => Effect.succeed(field("update", `unknown: ${error.reason}`)))));
+});
+const runningLines = Effect.fn("Cli.statusRunning")(function* (directory, record) {
+    const now = yield* DateTime.now;
+    const runs = yield* listRuns(record.launch.port).pipe(Effect.map(openRuns), Effect.catchTag("OperatorApiError", (error) => Effect.succeed(`unavailable: ${error.reason}`)));
+    const installed = installedInInstance(yield* realPathOrSelf(directory), yield* realPathOrSelf(record.launch.script));
+    const lines = [
+        record.stoppingSince === undefined
+            ? `usine is running in ${directory}.`
+            : `usine is stopping in ${directory}. Its drain started at ${DateTime.formatIso(record.stoppingSince)} (${ago(record.stoppingSince, now)}).`,
+        field("pid", String(record.pid)),
+        field("address", `http://${SERVER_HOST}:${record.launch.port}`),
+        ...Option.toArray(Option.map(record.launch.origin, (origin) => field("origin", origin))),
+        field("engine", `${SERVER_PACKAGE} ${record.version}, ${installed ? "installed in the instance" : `from ${record.launch.script}`}`),
+        field("started", `${DateTime.formatIso(record.startedAt)} (${ago(record.startedAt, now)})`),
+        ...Option.toArray(yield* serviceLine(record)),
+        field("runs", runs),
+    ];
+    // The same entry point at another version means that the install changed after the start.
+    if (process.argv[1] === record.launch.script) {
+        const version = yield* packageVersion().pipe(Effect.option);
+        if (Option.isSome(version) && version.value !== record.version) {
+            lines.push(field("installed", `${SERVER_PACKAGE} ${version.value}. Run usine restart to run it.`));
+        }
+    }
+    lines.push(...Option.toArray(yield* updateLine(directory, record, installed)));
+    return lines;
+});
+const reportOf = Effect.fn("Cli.statusReport")(function* (directory, state) {
+    switch (state._tag) {
+        case "Running":
+            return { running: true, lines: yield* runningLines(directory, state.record) };
+        case "Unrecorded":
+            return {
+                running: true,
+                lines: [
+                    Option.match(state.pid, {
+                        onNone: () => `A process holds .usine/instance.lock in ${directory}, but .usine/instance.pid names no running process.`,
+                        onSome: (pid) => `usine is running in ${directory} with pid ${pid}, without .usine/instance.json. It is a usine version that doesn't write one, or it is still starting.`,
+                    }),
+                ],
+            };
+        case "Stopped":
+            return {
+                running: false,
+                lines: [
+                    `usine is not running in ${directory}.`,
+                    ...Option.toArray(Option.map(state.stale, (pid) => field("stale", `pid ${pid} in .usine/ exited without removing its files. The next usine up replaces them.`))),
+                ],
+            };
+    }
+});
+/**
+ * Reads whether `usine up` runs in the instance folder, with one request to its operator API and,
+ * for an engine installed from a pin, one `npm view`.
+ */
+export const status = Effect.fn("Cli.status")(function* (directory) {
+    const report = yield* reportOf(directory, yield* probeInstance(directory));
+    return report;
+});
+//# sourceMappingURL=status.js.map

package/dist/status.js.map

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

package/dist/stop.d.ts

@@ -0,0 +1,81 @@
+import { Effect, Option, Schema } from "effect";
+import type { LifecycleOptions } from "./cli.ts";
+import { type InstanceRecord } from "./instance/record.ts";
+/** The CLI command that stops the instance. */
+export declare const LifecycleCommandName: Schema.Literals<readonly ["stop", "restart", "upgrade"]>;
+export type LifecycleCommandName = typeof LifecycleCommandName.Type;
+declare const StopTimeoutError_base: Schema.Class<StopTimeoutError, Schema.TaggedStruct<"StopTimeoutError", {
+    readonly command: Schema.Literals<readonly ["stop", "restart", "upgrade"]>;
+    readonly pid: Schema.brand<Schema.Int, "ProcessId">;
+    readonly timeout: Schema.Duration;
+    /** The Runs whose Attempts were live when the stop started. */
+    readonly runs: Schema.$Array<Schema.brand<Schema.NonEmptyString, "RunId">>;
+    /** The systemd service that runs the instance, which `systemctl start` starts again. */
+    readonly unit: Schema.Option<Schema.brand<Schema.String, "SystemdUnit">>;
+}>, import("effect/Cause").YieldableError>;
+/** The instance process didn't exit within the timeout. Its drain continues. */
+export declare class StopTimeoutError extends StopTimeoutError_base {
+}
+declare const KillTimeoutError_base: Schema.Class<KillTimeoutError, Schema.TaggedStruct<"KillTimeoutError", {
+    readonly command: Schema.Literals<readonly ["stop", "restart", "upgrade"]>;
+    readonly pid: Schema.brand<Schema.Int, "ProcessId">;
+    readonly timeout: Schema.Duration;
+}>, import("effect/Cause").YieldableError>;
+/** The instance process still ran `timeout` after `--force` sent it `SIGKILL`. */
+export declare class KillTimeoutError extends KillTimeoutError_base {
+}
+declare const InstanceNotRunningError_base: Schema.Class<InstanceNotRunningError, Schema.TaggedStruct<"InstanceNotRunningError", {
+    readonly command: Schema.Literals<readonly ["stop", "restart", "upgrade"]>;
+    readonly directory: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** No `usine up` runs in the instance folder. */
+export declare class InstanceNotRunningError extends InstanceNotRunningError_base {
+}
+declare const UnrecordedInstanceError_base: Schema.Class<UnrecordedInstanceError, Schema.TaggedStruct<"UnrecordedInstanceError", {
+    readonly command: Schema.Literals<readonly ["stop", "restart", "upgrade"]>;
+    readonly directory: Schema.String;
+    readonly pid: Schema.Option<Schema.brand<Schema.Int, "ProcessId">>;
+}>, import("effect/Cause").YieldableError>;
+/** A process holds the instance lock without an instance record, so its launch is unknown. */
+export declare class UnrecordedInstanceError extends UnrecordedInstanceError_base {
+}
+declare const LiveAttemptsError_base: Schema.Class<LiveAttemptsError, Schema.TaggedStruct<"LiveAttemptsError", {
+    readonly command: Schema.Literals<readonly ["stop", "restart", "upgrade"]>;
+    readonly runs: Schema.$Array<Schema.brand<Schema.NonEmptyString, "RunId">>;
+}>, import("effect/Cause").YieldableError>;
+/** Runs have live Attempts, and the operator didn't pass `--force`. */
+export declare class LiveAttemptsError extends LiveAttemptsError_base {
+}
+declare const MissingEnvironmentError_base: Schema.Class<MissingEnvironmentError, Schema.TaggedStruct<"MissingEnvironmentError", {
+    readonly command: Schema.Literals<readonly ["stop", "restart", "upgrade"]>;
+    readonly variables: Schema.$Array<Schema.NonEmptyString>;
+}>, import("effect/Cause").YieldableError>;
+/**
+ * Neither the shell that would start the new `usine up` nor `.env` sets variables that its startup
+ * needs.
+ */
+export declare class MissingEnvironmentError extends MissingEnvironmentError_base {
+}
+/**
+ * Fails with `MissingEnvironmentError` if the current `ConfigProvider` lacks a gateway admin token
+ * variable of the instance that listens on `port`. The new `usine up` inherits this process's
+ * environment and reads the instance folder's `.env`, and doesn't start without them.
+ */
+export declare const refuseMissingEnvironment: (command: "restart" | "stop" | "upgrade", port: number & import("effect/Brand").Brand<"ServerPort">) => Effect.Effect<undefined, MissingEnvironmentError, import("effect/http/HttpClient").HttpClient>;
+/**
+ * Fails with `LiveAttemptsError` if a Run of the instance that listens on `port` has a live
+ * Attempt, unless `force` is set.
+ */
+export declare const refuseLiveAttempts: (command: "restart" | "stop" | "upgrade", port: number & import("effect/Brand").Brand<"ServerPort">, force: boolean) => Effect.Effect<undefined, LiveAttemptsError, import("effect/http/HttpClient").HttpClient>;
+/**
+ * Starts the drain of the instance process and waits for the process to exit: through
+ * `systemctl stop --no-block` if `unit` runs it, so that systemd doesn't restart it, else with
+ * `SIGTERM`. With `force`, sends a second `SIGTERM`, which ends the drain without waiting for
+ * running Attempts, and sends `SIGKILL` if the process still runs after the timeout. Doesn't repeat
+ * the first signal to a process that records that it is stopping.
+ */
+export declare const stopProcess: (command: "restart" | "stop" | "upgrade", pid: number & import("effect/Brand").Brand<"ProcessId">, record: Option.Option<InstanceRecord>, unit: Option.Option<string & import("effect/Brand").Brand<"SystemdUnit">>, options: LifecycleOptions) => Effect.Effect<undefined, KillTimeoutError | import("./instance/state.ts").SignalError | StopTimeoutError | import("./instance/systemd.ts").SystemctlError, import("effect/process/ChildProcessSpawner").ChildProcessSpawner | import("effect/http/HttpClient").HttpClient>;
+/** Stops the `usine up` of the instance folder, and succeeds if none runs. */
+export declare const stop: (directory: string & import("effect/Brand").Brand<"InstanceDirectory">, options: LifecycleOptions) => Effect.Effect<undefined, import("./instance/lock.ts").InstanceLockError | KillTimeoutError | import("./instance/state.ts").SignalError | StopTimeoutError | import("./instance/systemd.ts").SystemctlError | UnrecordedInstanceError, import("effect/process/ChildProcessSpawner").ChildProcessSpawner | import("effect/FileSystem").FileSystem | import("effect/http/HttpClient").HttpClient>;
+export {};
+//# sourceMappingURL=stop.d.ts.map

package/dist/stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.d.ts","sourceRoot":"","sources":["../src/stop.ts"],"names":[],"mappings":"AAEA,OAAO,EAA6B,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAQ,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,KAAK,cAAc,EAAa,MAAM,sBAAsB,CAAC;AAWtE,+CAA+C;AAC/C,eAAO,MAAM,oBAAoB,0DAAkD,CAAC;AACpF,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAC,IAAI,CAAC;;;;;IASlE,+DAA+D;;IAE/D,wFAAwF;;;AAT1F,gFAAgF;AAChF,qBAAa,gBAAiB,SAAQ,qBAUpC;CAAG;;;;;;AAEL,kFAAkF;AAClF,qBAAa,gBAAiB,SAAQ,qBAMpC;CAAG;;;;;AAEL,iDAAiD;AACjD,qBAAa,uBAAwB,SAAQ,4BAE4C;CAAG;;;;;;AAE5F,8FAA8F;AAC9F,qBAAa,uBAAwB,SAAQ,4BAM3C;CAAG;;;;;AAEL,uEAAuE;AACvE,qBAAa,iBAAkB,SAAQ,sBAE6C;CAAG;;;;;AAEvF;;;GAGG;AACH,qBAAa,uBAAwB,SAAQ,4BAK3C;CAAG;AAEL;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,wMA0BnC,CAAC;AAeH;;;GAGG;AACH,eAAO,MAAM,kBAAkB,kNAa7B,CAAC;AA+BH;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,+fAwDtB,CAAC;AAEH,8EAA8E;AAC9E,eAAO,MAAM,IAAI,seAkBf,CAAC"}

package/dist/stop.js

@@ -0,0 +1,195 @@
+import { RunId } from "@usine/core/run";
+import { Config, Console, Duration, Effect, Option, Schema } from "effect";
+import { ProcessId } from "./instance/record.js";
+import { gatewayTokenVariables, hasLiveAttempt, listRuns } from "./instance/operator-api.js";
+import { probeInstance, processAlive, signalProcess } from "./instance/state.js";
+import { SystemdUnit, supervisingUnit, systemctl } from "./instance/systemd.js";
+const EXIT_POLL_INTERVAL = "200 millis";
+/** Separates the two signals of `--force`, so that the OS doesn't merge them into one. */
+const SECOND_SIGNAL_DELAY = "250 millis";
+/** How long `--force` waits for the process to exit after `SIGKILL`. */
+const KILL_EXIT_TIMEOUT = Duration.seconds(5);
+/** The CLI command that stops the instance. */
+export const LifecycleCommandName = Schema.Literals(["stop", "restart", "upgrade"]);
+/** The instance process didn't exit within the timeout. Its drain continues. */
+export class StopTimeoutError extends Schema.TaggedError("@usine/server/StopTimeoutError")("StopTimeoutError", {
+    command: LifecycleCommandName,
+    pid: ProcessId,
+    timeout: Schema.Duration,
+    /** The Runs whose Attempts were live when the stop started. */
+    runs: Schema.Array(RunId),
+    /** The systemd service that runs the instance, which `systemctl start` starts again. */
+    unit: Schema.Option(SystemdUnit),
+}) {
+}
+/** The instance process still ran `timeout` after `--force` sent it `SIGKILL`. */
+export class KillTimeoutError extends Schema.TaggedError("@usine/server/KillTimeoutError")("KillTimeoutError", {
+    command: LifecycleCommandName,
+    pid: ProcessId,
+    timeout: Schema.Duration,
+}) {
+}
+/** No `usine up` runs in the instance folder. */
+export class InstanceNotRunningError extends Schema.TaggedError("@usine/server/InstanceNotRunningError")("InstanceNotRunningError", { command: LifecycleCommandName, directory: Schema.String }) {
+}
+/** A process holds the instance lock without an instance record, so its launch is unknown. */
+export class UnrecordedInstanceError extends Schema.TaggedError("@usine/server/UnrecordedInstanceError")("UnrecordedInstanceError", {
+    command: LifecycleCommandName,
+    directory: Schema.String,
+    pid: Schema.Option(ProcessId),
+}) {
+}
+/** Runs have live Attempts, and the operator didn't pass `--force`. */
+export class LiveAttemptsError extends Schema.TaggedError("@usine/server/LiveAttemptsError")("LiveAttemptsError", { command: LifecycleCommandName, runs: Schema.Array(RunId) }) {
+}
+/**
+ * Neither the shell that would start the new `usine up` nor `.env` sets variables that its startup
+ * needs.
+ */
+export class MissingEnvironmentError extends Schema.TaggedError("@usine/server/MissingEnvironmentError")("MissingEnvironmentError", {
+    command: LifecycleCommandName,
+    variables: Schema.Array(Schema.NonEmptyString),
+}) {
+}
+/**
+ * Fails with `MissingEnvironmentError` if the current `ConfigProvider` lacks a gateway admin token
+ * variable of the instance that listens on `port`. The new `usine up` inherits this process's
+ * environment and reads the instance folder's `.env`, and doesn't start without them.
+ */
+export const refuseMissingEnvironment = Effect.fn("Cli.refuseMissingEnvironment")(function* (command, port) {
+    const names = yield* gatewayTokenVariables(port).pipe(Effect.tapError((error) => Effect.logWarning("Could not read the gateway token variables of the instance", {
+        url: error.url,
+        reason: error.reason,
+    })), Effect.orElseSucceed(() => []));
+    const missing = [];
+    for (const name of names) {
+        const value = yield* Config.option(Config.String(name)).pipe(Effect.orElseSucceed(() => Option.none()));
+        if (Option.isNone(value))
+            missing.push(name);
+    }
+    if (missing.length === 0)
+        return;
+    yield* Effect.logInfo("Refusing to stop the instance: the new process would lack variables", {
+        command,
+        variables: missing,
+    });
+    return yield* new MissingEnvironmentError({ command, variables: missing });
+});
+/** Returns the Runs with a live Attempt, or none if the operator API doesn't answer. */
+const liveRuns = (port) => listRuns(port).pipe(Effect.map((runs) => runs.filter(hasLiveAttempt).map(({ id }) => id)), Effect.tapError((error) => Effect.logWarning("Could not list the running runs; the drain still waits for them", {
+    url: error.url,
+    reason: error.reason,
+})), Effect.orElseSucceed(() => []));
+/**
+ * Fails with `LiveAttemptsError` if a Run of the instance that listens on `port` has a live
+ * Attempt, unless `force` is set.
+ */
+export const refuseLiveAttempts = Effect.fn("Cli.refuseLiveAttempts")(function* (command, port, force) {
+    if (force)
+        return;
+    const runs = yield* liveRuns(port);
+    if (runs.length === 0)
+        return;
+    yield* Effect.logInfo("Refusing to stop the instance while runs have live attempts", {
+        command,
+        runs,
+    });
+    return yield* new LiveAttemptsError({ command, runs });
+});
+/** Returns `true` once the process has exited, or `false` after `timeout`. */
+const waitForExit = (pid, timeout) => Effect.gen(function* () {
+    while (yield* processAlive(pid))
+        yield* Effect.sleep(EXIT_POLL_INTERVAL);
+}).pipe(Effect.timeoutOption(timeout), Effect.map(Option.isSome));
+/**
+ * Sends `SIGKILL` to a process that a forced stop didn't end within `timeout`, and waits for it to
+ * exit.
+ */
+const killProcess = Effect.fn("Cli.killProcess")(function* (command, pid, timeout) {
+    yield* Effect.annotateCurrentSpan({ command, pid });
+    yield* signalProcess(pid, "SIGKILL");
+    yield* Console.log(`usine (pid ${pid}) did not exit within ${Duration.format(timeout)}. Sent SIGKILL: the next start reattaches the running attempts.`);
+    if (yield* waitForExit(pid, KILL_EXIT_TIMEOUT))
+        return;
+    yield* Effect.logWarning("The instance process did not exit after SIGKILL", {
+        command,
+        pid,
+        timeoutSeconds: Duration.toSeconds(KILL_EXIT_TIMEOUT),
+    });
+    return yield* new KillTimeoutError({ command, pid, timeout: KILL_EXIT_TIMEOUT });
+});
+/**
+ * Starts the drain of the instance process and waits for the process to exit: through
+ * `systemctl stop --no-block` if `unit` runs it, so that systemd doesn't restart it, else with
+ * `SIGTERM`. With `force`, sends a second `SIGTERM`, which ends the drain without waiting for
+ * running Attempts, and sends `SIGKILL` if the process still runs after the timeout. Doesn't repeat
+ * the first signal to a process that records that it is stopping.
+ */
+export const stopProcess = Effect.fn("Cli.stopProcess")(function* (command, pid, record, unit, options) {
+    yield* Effect.annotateCurrentSpan({
+        command,
+        pid,
+        force: options.force,
+        unit: Option.getOrUndefined(unit),
+    });
+    const stopping = Option.exists(record, ({ stoppingSince }) => stoppingSince !== undefined);
+    const runs = Option.isSome(record) ? yield* liveRuns(record.value.launch.port) : [];
+    if (stopping) {
+        yield* Console.log(`usine (pid ${pid}) is already stopping. Waiting for it to exit.`);
+    }
+    else if (Option.isSome(unit)) {
+        yield* Console.log(`Stopping usine (pid ${pid}) with systemctl stop ${unit.value}.`);
+        yield* systemctl(unit.value, ["stop", "--no-block"]);
+        yield* Effect.logInfo("Asked systemd to stop the instance's service", {
+            command,
+            pid,
+            unit: unit.value,
+        });
+    }
+    else {
+        yield* Console.log(`Stopping usine (pid ${pid}).`);
+        yield* signalProcess(pid, "SIGTERM");
+    }
+    if (options.force) {
+        yield* Effect.sleep(SECOND_SIGNAL_DELAY);
+        if (yield* processAlive(pid)) {
+            yield* signalProcess(pid, "SIGTERM");
+            yield* Console.log("Sent a second SIGTERM: usine stops without waiting for running attempts, and the next start reattaches them.");
+        }
+    }
+    else if (runs.length > 0) {
+        yield* Console.log(`Waiting for the running attempts of ${runs.length === 1 ? "run" : "runs"} ${runs.join(", ")} to end.`);
+    }
+    if (!(yield* waitForExit(pid, options.timeout))) {
+        yield* Effect.logWarning("The instance process did not exit before the timeout", {
+            command,
+            pid,
+            force: options.force,
+            timeoutSeconds: Duration.toSeconds(options.timeout),
+        });
+        if (!options.force) {
+            return yield* new StopTimeoutError({ command, pid, timeout: options.timeout, runs, unit });
+        }
+        yield* killProcess(command, pid, options.timeout);
+    }
+    yield* Effect.logInfo("The instance process exited", { command, pid });
+    yield* Console.log("usine stopped.");
+});
+/** Stops the `usine up` of the instance folder, and succeeds if none runs. */
+export const stop = Effect.fn("Cli.stop")(function* (directory, options) {
+    const state = yield* probeInstance(directory);
+    if (state._tag === "Stopped") {
+        yield* Console.log(`usine is not running in ${directory}.`);
+        return;
+    }
+    if (state._tag === "Running") {
+        const { record } = state;
+        const unit = yield* supervisingUnit(record.pid, record.systemdUnit);
+        return yield* stopProcess("stop", record.pid, Option.some(record), unit, options);
+    }
+    if (Option.isNone(state.pid)) {
+        return yield* new UnrecordedInstanceError({ command: "stop", directory, pid: state.pid });
+    }
+    return yield* stopProcess("stop", state.pid.value, Option.none(), Option.none(), options);
+});
+//# sourceMappingURL=stop.js.map

package/dist/stop.js.map

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

package/dist/system-sleep.d.ts

@@ -0,0 +1,9 @@
+import { Effect } from "effect";
+import { ChildProcessSpawner } from "effect/process";
+/**
+ * Logs a warning if this Mac can sleep while `usine up` runs: system sleep is on, and `caffeinate`
+ * doesn't prevent it. A sleep closes the SSH connections to Workers and to the Gateway, and the
+ * orchestrator does nothing until the Mac wakes.
+ */
+export declare const warnIfSystemSleeps: () => Effect.Effect<void, never, ChildProcessSpawner.ChildProcessSpawner>;
+//# sourceMappingURL=system-sleep.d.ts.map