@usine/server 0.2.1 → 0.4.0

package/dist/main.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,20 @@
+import { Effect, Schema } from "effect";
+declare const PackageLookupError_base: Schema.Class<PackageLookupError, Schema.TaggedStruct<"PackageLookupError", {
+    readonly name: Schema.String;
+    readonly spec: Schema.String;
+    readonly reason: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** The registry has no version of the package that matches the spec, or npm couldn't ask it. */
+export declare class PackageLookupError extends PackageLookupError_base {
+}
+/**
+ * Returns the version that `spec`, a version, range, or dist-tag, resolves to on the registry: the
+ * highest one for a range.
+ */
+export declare const resolveVersion: (directory: string, name: string, spec: string) => Effect.Effect<string, PackageLookupError, import("effect/process/ChildProcessSpawner").ChildProcessSpawner>;
+/** Returns the published dependencies of `name@version`, with their version specs. */
+export declare const dependenciesOf: (directory: string, name: string, version: string) => Effect.Effect<{
+    readonly [x: string]: string;
+}, PackageLookupError, import("effect/process/ChildProcessSpawner").ChildProcessSpawner>;
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;;;AAKxC,gGAAgG;AAChG,qBAAa,kBAAmB,SAAQ,uBAMtC;CAAG;AAYL;;;GAGG;AACH,eAAO,MAAM,cAAc,gKAkBzB,CAAC;AAEH,sFAAsF;AACtF,eAAO,MAAM,cAAc;;wFAYzB,CAAC"}

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/reload-signal.d.ts

@@ -0,0 +1,8 @@
+import type { CurrentInstance } from "@usine/orchestrator/current-instance";
+import { Effect } from "effect";
+/**
+ * Reloads the instance folder on each SIGHUP until the scope closes, instead of exiting. A SIGHUP
+ * during a reload triggers one more reload.
+ */
+export declare const reloadOnHangup: (instances: CurrentInstance["Service"]) => Effect.Effect<void, never, import("effect/Scope").Scope>;
+//# sourceMappingURL=reload-signal.d.ts.map

package/dist/reload-signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reload-signal.d.ts","sourceRoot":"","sources":["../src/reload-signal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAS,MAAM,QAAQ,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,cAAc,cAAe,eAAe,CAAC,SAAS,CAAC,6DAyBhE,CAAC"}

package/dist/reload-signal.js

@@ -0,0 +1,21 @@
+import { Effect, Queue } from "effect";
+/**
+ * Reloads the instance folder on each SIGHUP until the scope closes, instead of exiting. A SIGHUP
+ * during a reload triggers one more reload.
+ */
+export const reloadOnHangup = (instances) => Effect.gen(function* () {
+    const signals = yield* Queue.sliding(1);
+    yield* Effect.acquireRelease(Effect.sync(() => {
+        const onSignal = () => {
+            Queue.offerUnsafe(signals, undefined);
+        };
+        process.on("SIGHUP", onSignal);
+        return onSignal;
+    }), (onSignal) => Effect.sync(() => {
+        process.removeListener("SIGHUP", onSignal);
+    }));
+    yield* Effect.forkScoped(Queue.take(signals).pipe(Effect.andThen(Effect.logInfo("SIGHUP received; reloading the instance folder")), Effect.andThen(instances.reload), 
+    // The reload logs its own outcome.
+    Effect.ignore, Effect.forever));
+});
+//# sourceMappingURL=reload-signal.js.map

package/dist/reload-signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reload-signal.js","sourceRoot":"","sources":["../src/reload-signal.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAEvC;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,SAAqC,EAAE,EAAE,CACtE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,OAAO,CAAO,CAAC,CAAC,CAAC;IAC9C,KAAK,CAAC,CAAC,MAAM,CAAC,cAAc,CAC1B,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QACf,MAAM,QAAQ,GAAG,GAAG,EAAE;YACpB,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACxC,CAAC,CAAC;QACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC/B,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC,EACF,CAAC,QAAQ,EAAE,EAAE,CACX,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QACf,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC,CAAC,CACL,CAAC;IACF,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CACtB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CACtB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,gDAAgD,CAAC,CAAC,EAChF,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC;IAChC,mCAAmC;IACnC,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,OAAO,CACf,CACF,CAAC;AACJ,CAAC,CAAC,CAAC"}

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/shutdown.d.ts

@@ -1,7 +1,10 @@
 import { Deferred, Duration, Effect, Scope } from "effect";
-/** Protects startup and running work with a bounded drain before runtime resources close. */
+/**
+ * Runs `startup` and its work, and on shutdown drains them within `deadline` before runtime
+ * resources close. Reads `deadline` when the drain starts.
+ */
 export declare const withGracefulShutdown: <A, E, R, E2, R2>(startup: Effect.Effect<{
     readonly running: Effect.Effect<A, E, R>;
     readonly drain: Effect.Effect<void>;
-}, E2, R2>, requested: Deferred.Deferred<void>, deadline: Duration.Duration) => Effect.Effect<A, E | E2, Exclude<Exclude<R, Scope.Scope>, Scope.Scope> | Exclude<Exclude<R2, Scope.Scope>, Scope.Scope>>;
+}, E2, R2>, requested: Deferred.Deferred<void>, deadline: Effect.Effect<Duration.Duration>) => Effect.Effect<A, E | E2, Exclude<Exclude<R, Scope.Scope>, Scope.Scope> | Exclude<Exclude<R2, Scope.Scope>, Scope.Scope>>;
 //# sourceMappingURL=shutdown.d.ts.map

package/dist/shutdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../src/shutdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAuB,KAAK,EAAE,MAAM,QAAQ,CAAC;AAuBhF,6FAA6F;AAC7F,eAAO,MAAM,oBAAoB,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,WACzC,MAAM,CAAC,MAAM,CACpB;IACE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;CACrC,EACD,EAAE,EACF,EAAE,CACH,aACU,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,YACxB,QAAQ,CAAC,QAAQ,6HAsE1B,CAAC"}
+{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../src/shutdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAuB,KAAK,EAAE,MAAM,QAAQ,CAAC;AAuBhF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,WACzC,MAAM,CAAC,MAAM,CACpB;IACE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;CACrC,EACD,EAAE,EACF,EAAE,CACH,aACU,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,YACxB,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,6HAwEzC,CAAC"}

package/dist/shutdown.js

@@ -14,19 +14,23 @@ const observeSignals = (requested, forced) => Effect.acquireRelease(Effect.sync(
     process.removeListener("SIGINT", onSignal);
     process.removeListener("SIGTERM", onSignal);
 }));
-/** Protects startup and running work with a bounded drain before runtime resources close. */
+/**
+ * Runs `startup` and its work, and on shutdown drains them within `deadline` before runtime
+ * resources close. Reads `deadline` when the drain starts.
+ */
 export const withGracefulShutdown = (startup, requested, deadline) => Effect.scoped(Effect.gen(function* () {
     const forced = yield* Deferred.make();
     yield* observeSignals(requested, forced);
-    // Acquired before the forks: their shutdown completes while runtime
-    // resources (database, executor, HTTP) are still available.
+    // Acquired before the forks, so their shutdown completes while runtime resources (database,
+    // executor, HTTP) are still available.
     const runtimeScope = yield* Effect.acquireRelease(Scope.make(), (scope, exit) => Scope.close(scope, exit));
     const started = yield* Effect.forkScoped(Scope.provide(startup, runtimeScope));
     const running = yield* Effect.forkScoped(Fiber.join(started).pipe(Effect.flatMap(({ running }) => Deferred.isDone(requested).pipe(Effect.flatMap((stopped) => stopped ? Effect.never : Scope.provide(running, runtimeScope))))));
     return yield* Fiber.join(running).pipe(Effect.onInterrupt(() => Effect.gen(function* () {
         yield* Deferred.succeed(requested, undefined);
+        const limit = yield* deadline;
         yield* Effect.logInfo("Orchestrator shutdown started", {
-            deadlineMilliseconds: Duration.toMillis(deadline),
+            deadlineMilliseconds: Duration.toMillis(limit),
         });
         const stopping = yield* Effect.forkScoped(Fiber.interrupt(running).pipe(Effect.interruptible), { startImmediately: true });
         const drain = Fiber.join(started).pipe(Effect.matchEffect({
@@ -35,7 +39,9 @@ export const withGracefulShutdown = (startup, requested, deadline) => Effect.sco
         }));
         // Finalizers are uninterruptible; raced waits must remain
         // interruptible so the losing drain or signal wait can be stopped.
-        const outcome = yield* Effect.raceFirst(Effect.all([drain, Fiber.join(stopping)], { concurrency: "unbounded" }).pipe(Effect.timeoutOption(deadline), Effect.map((result) => Option.isSome(result) ? "drained" : "deadline"), Effect.interruptible), Deferred.await(forced).pipe(Effect.as("forced"), Effect.interruptible));
+        const outcome = yield* Effect.raceFirst(Effect.all([drain, Fiber.join(stopping)], { concurrency: "unbounded" }).pipe(
+        // An infinite deadline never elapses; only the second signal ends the drain.
+        Effect.timeoutOption(limit), Effect.map((result) => Option.isSome(result) ? "drained" : "deadline"), Effect.interruptible), Deferred.await(forced).pipe(Effect.as("forced"), Effect.interruptible));
         if (outcome === "drained") {
             yield* Effect.logInfo("Orchestrator exiting after graceful drain");
         }

package/dist/shutdown.js.map

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