@intentius/chant-lexicon-fly 0.90.0 → 0.93.0

package/dist/op/activities/index.d.ts

@@ -7,12 +7,20 @@
  */
 export { flyApply, toApplyResult, flyDelete, applyApp, applyMachine, destroyMachine, deleteApp, listMachines, pruneMachines, waitForMachine, acquireLease, releaseLease, withLease, resolveEndpoint, parsePlan, isAppRequest, isMachineRequest, machineAppSegment, resolveApp, appNameFromRequest, isChantOwned, configEqual, isLeaseConflict, defaultFlyHttp, DEFAULT_FLAPS_BASE_URL, LEASE_NONCE_HEADER, } from "./fly-apply.js";
 export type { FlyApplyArgs, FlyPlan, FlapsRequest, FlapsMachine, FlyHttp, WaitOpts, ApplyCtx } from "./fly-apply.js";
+export { flyMachineRelease, flyMachineExec, flyMachineRestart, flyMachineStop, flyMachineVerify, flyMachineRestore, } from "./machine-release.js";
+export { flyRelease } from "./fly-release-step.js";
+export type { FlyReleaseArgs, FlyReleaseResult } from "./fly-release-step.js";
+export { flyRollback } from "./fly-rollback-step.js";
+export type { FlyRollbackArgs, FlyRollbackResult } from "./fly-rollback-step.js";
+export type { MachineRelease, FlyMachineReleaseArgs, FlyMachineReleaseResult, MachineFile, FlyMachineExecArgs, FlyMachineExecResult, FlyMachineStateArgs, FlyMachineVerifyArgs, FlyMachineRestoreArgs, } from "./machine-release.js";
 export { flapsUp, flapsDown, flapsRunCommand, flapsRmCommand, flapsExistsCommand, flapsHealthUrl, flapsEndpoint, } from "./flaps.js";
 export type { FlapsUpArgs, FlapsDownArgs } from "./flaps.js";
 export { spriteCreate, spriteExec, spriteCheckpoint, spriteRestore, listCheckpoints, spriteDestroy, spriteDelete, spriteUrl, resolveSpritesEndpoint, resolveSpritesToken, defaultSpritesHttp, spriteCreateBody, parseCreateResponse, accumulateExecFrames, parseCheckpointNdjson, pickCheckpointByComment, splitCommand, spriteExecWsUrl, DEFAULT_SPRITES_BASE_URL, } from "./sprites.js";
 export type { SpritesHttp, SpriteCreateArgs, SpriteCreateResult, SpriteExecArgs, SpriteExecResult, SpriteCheckpointArgs, SpriteCheckpointResult, SpriteRestoreArgs, ListCheckpointsArgs, Checkpoint, SpriteDestroyArgs, SpriteDeleteArgs, SpriteUrlArgs, SpriteUrlResult, } from "./sprites.js";
 export { spriteServiceCreate, spriteServiceGet, spriteServiceList, spriteServiceStart, spriteServiceStop, spriteServiceDelete, spriteServiceLogs, spriteServiceCreateBody, parseServiceLogNdjson, } from "./sprite-services.js";
 export type { SpriteService, SpriteServiceState, SpriteServiceCreateArgs, SpriteServiceGetArgs, SpriteServiceListArgs, SpriteServiceStartArgs, SpriteServiceStopArgs, SpriteServiceDeleteArgs, SpriteServiceLogsArgs, SpriteServiceLogsResult, } from "./sprite-services.js";
+export { spriteServicesObserve, spriteServiceRestart, declaredServices, findSpriteEnv, parseServicesList, probeHealth, } from "./sprite-service-converge.js";
+export type { DeclaredSpriteService, SpriteServicesObserveArgs, SpriteServicesObserveResult, SpriteServiceRestartArgs, SpriteServiceRestartResult, } from "./sprite-service-converge.js";
 export { spriteWriteFile, spriteReadFile, spriteListDir, spriteRemove, spriteFsUrl, defaultSpritesRawHttp, } from "./sprite-fs.js";
 export type { SpritesRawHttp, SpriteWriteFileArgs, SpriteReadFileArgs, SpriteReadFileResult, SpriteListDirArgs, SpriteDirEntry, SpriteRemoveArgs, } from "./sprite-fs.js";
 export { spriteApplyNetworkPolicy, spriteApplyServices, validateNetworkRules, networkRulesEqual, validateServices, serviceConfigEqual, } from "./sprite-config.js";

package/dist/op/activities/index.d.ts.map

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

package/dist/op/activities/machine-release.d.ts

@@ -0,0 +1,192 @@
+/**
+ * The release a Fly Machine serves, and the Machines activities that put one
+ * there (#2736, ws-056).
+ *
+ * chud's `Chud::FlySite` ran a site as one App served by one Machine and kept
+ * the release in the Machine's metadata. That moves here: the App and the
+ * Machine are this lexicon's own resources, and a release is the declared
+ * Machine with {@link RELEASE_METADATA_KEYS} stamped into its
+ * `config.metadata`. Because the record is on the Machine itself, any checkout
+ * can read which release is serving (`describeResources` reports it, and
+ * `chant components status --live` compares it with the release ledger).
+ *
+ * The site steps are activities over the Machines API, each usable from an
+ * Op by name and composed by the `fly-release` and `fly-rollback` capabilities
+ * (../../components/fly-release.ts):
+ *
+ * - {@link flyMachineRelease}: upload and start. Apply the declared plan with
+ *   the Machine serving the release (its image or env overridden when the
+ *   release says so), and report the release and config it replaced.
+ * - {@link flyMachineExec}: run a command inside the Machine (a migration).
+ * - {@link flyMachineRestart}, {@link flyMachineStop}: under a lease, then
+ *   wait for the Machine to settle.
+ * - {@link flyMachineVerify}: the Machine is started with this release in its
+ *   metadata, and, given a URL, its health endpoint answers.
+ * - {@link flyMachineRestore}: put a recorded Machine config back (restore on
+ *   a failed release, and rollback).
+ *
+ * Every activity takes the flaps endpoint and token the way `flyApply` does
+ * (`FLY_FLAPS_BASE_URL`, `FLY_API_TOKEN`), so the same code reaches mudflaps
+ * or a real Fly org, and an injectable `http` for tests (./machines-fake.ts).
+ */
+import { type ApplyCtx, type FlapsMachine, type FlapsRequest, type FlyHttp, type FlyPlan, type WaitOpts } from "./fly-apply.js";
+import { type MachineConfig, type MachineRelease } from "../../release-metadata.js";
+export { RELEASE_METADATA_KEYS, readMachineRelease, withReleaseMetadata } from "../../release-metadata.js";
+export type { MachineRelease } from "../../release-metadata.js";
+/** The App and Machine a release targets in a plan. */
+export interface ReleaseTarget {
+    app: string;
+    /** The plan entity that declares the Machine. */
+    entity: string;
+    /** The Machine's name on Fly (its `name`, else the entity name). */
+    name: string;
+    request: FlapsRequest;
+}
+/**
+ * The Machine a release targets: the plan's one Machine, or the one `machine`
+ * names (an entity name or a Machine name). Pure.
+ */
+export declare function releaseTarget(plan: FlyPlan, machine?: string): ReleaseTarget;
+/** The live Machine named `name` (or with id `name`) in `app`; undefined when there is none. */
+export declare function findMachine(ctx: ApplyCtx, app: string, name: string, http: FlyHttp, signal?: AbortSignal): Promise<FlapsMachine | undefined>;
+/** Where to reach flaps, as every activity here takes it. */
+export interface FlapsTarget {
+    /** flaps endpoint override. Default: `FLY_FLAPS_BASE_URL`, else real Fly. */
+    endpoint?: string;
+    /** Bearer token for real Fly. Default: `FLY_API_TOKEN`. */
+    token?: string;
+}
+export interface FlyMachineReleaseArgs extends FlapsTarget {
+    /** Path to the fly build output (`chant build --lexicon fly -o <path>`). */
+    planPath?: string;
+    /** The plan itself, in place of `planPath`. */
+    plan?: FlyPlan;
+    /** The Machine that serves the release, when the plan declares more than one. */
+    machine?: string;
+    /** The release to serve. `previousDigest` is filled in from the Machine it replaces. */
+    release: MachineRelease;
+    /** An image to run in place of the declared one (a digest-pinned image a publish step produced). */
+    image?: string;
+    /** Env to add to the declared Machine's env. */
+    env?: Record<string, string>;
+    /**
+     * Files the release puts on the Machine, added to the declared ones: a
+     * source release's tree (#2782). A declared file at the same path is
+     * replaced.
+     */
+    files?: MachineFile[];
+    /** The command the Machine starts, in place of the image's: an argv, or a string run with `sh -c`. */
+    cmd?: string[] | string;
+    wait?: WaitOpts;
+}
+/** One file a Machine's config carries, as the Machines API takes it. */
+export interface MachineFile {
+    guest_path: string;
+    /** The file's bytes, base64. */
+    raw_value: string;
+    /** Unix mode, such as 0o755 for an executable. */
+    mode?: number;
+}
+export interface FlyMachineReleaseResult {
+    app: string;
+    machine: {
+        id: string;
+        name: string;
+    };
+    /** What the apply did to the Machine. */
+    action: "created" | "updated" | "noop";
+    /** The release the Machine serves now. */
+    release: MachineRelease;
+    /** The Machine config applied: what a later rollback to this release puts back. */
+    config: MachineConfig;
+    /** What the Machine served before, when it existed: its release (if it named one) and its config. */
+    previous: {
+        release?: MachineRelease;
+        config: MachineConfig;
+    } | null;
+}
+/**
+ * Upload and start: apply the declared plan (the App, its Volumes, IPs,
+ * Secrets) with the Machine serving `release`. The Machine is updated in place
+ * under a lease, so the release serves from here on. A Machine that already
+ * serves this release keeps the `previousDigest` it shipped with, so running a
+ * release twice never makes it its own predecessor.
+ */
+export declare function flyMachineRelease(args: FlyMachineReleaseArgs, signal?: AbortSignal, http?: FlyHttp): Promise<FlyMachineReleaseResult>;
+export interface FlyMachineExecArgs extends FlapsTarget {
+    app: string;
+    /** The Machine's name or id. */
+    machine: string;
+    /** The command: an argv, or a string run with `sh -c`. */
+    command: string[] | string;
+    /** Seconds the Machines API lets the command run. Default 120. */
+    timeoutSecs?: number;
+}
+export interface FlyMachineExecResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+/**
+ * Run a command inside the Machine (the Machines API's exec). A non-zero exit
+ * throws, with the command's output, so the step fails rather than going on
+ * over a half-migrated database.
+ */
+export declare function flyMachineExec(args: FlyMachineExecArgs, signal?: AbortSignal, http?: FlyHttp): Promise<FlyMachineExecResult>;
+export interface FlyMachineStateArgs extends FlapsTarget {
+    app: string;
+    /** The Machine's name or id. */
+    machine: string;
+    wait?: WaitOpts;
+}
+/** Restart the Machine under a lease (the app starts again on migrated data), and wait for it to be started. */
+export declare function flyMachineRestart(args: FlyMachineStateArgs, signal?: AbortSignal, http?: FlyHttp): Promise<{
+    id: string;
+    state: string;
+}>;
+/** Stop the Machine under a lease, and wait for it to be stopped. A Machine that is not started is left alone. */
+export declare function flyMachineStop(args: FlyMachineStateArgs, signal?: AbortSignal, http?: FlyHttp): Promise<{
+    id: string;
+    state: string;
+}>;
+export interface FlyMachineVerifyArgs extends FlapsTarget {
+    app: string;
+    machine: string;
+    /** The release digest the Machine must name. */
+    digest: string;
+    /** The app's public URL; with it, its health endpoint must answer. */
+    url?: string;
+    /** Path of the health endpoint under `url`. Default `/health`. */
+    healthPath?: string;
+    /** How long to keep asking. Default 120s. */
+    timeoutMs?: number;
+    /** Delay between asks. Default 1s. */
+    intervalMs?: number;
+}
+/**
+ * The Machine is started and its metadata names release `digest`. Given a
+ * `url`, its health endpoint answers 2xx too, and when that answer is JSON
+ * naming a `revision` or `digest`, it is this release's (the commit or the
+ * digest). Retries until `timeoutMs`, then throws the last reason.
+ */
+export declare function flyMachineVerify(args: FlyMachineVerifyArgs, signal?: AbortSignal, http?: FlyHttp, fetchImpl?: typeof fetch): Promise<{
+    id: string;
+    release: MachineRelease;
+}>;
+export interface FlyMachineRestoreArgs extends FlapsTarget {
+    app: string;
+    machine: string;
+    /** The Machine config to put back, as a release applied it (its metadata names that release). */
+    config: MachineConfig;
+    wait?: WaitOpts;
+}
+/**
+ * Put a recorded Machine config back: update the Machine to exactly `config`
+ * under a lease and wait for it to be started. Used on a failed release (the
+ * config it replaced) and by a rollback (the config an earlier release applied).
+ */
+export declare function flyMachineRestore(args: FlyMachineRestoreArgs, signal?: AbortSignal, http?: FlyHttp): Promise<{
+    id: string;
+    release?: MachineRelease;
+}>;
+//# sourceMappingURL=machine-release.d.ts.map

package/dist/op/activities/machine-release.d.ts.map

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

package/dist/op/activities/machines-contract.d.ts

@@ -33,4 +33,12 @@ export declare const MACHINES_CONTRACT: readonly MachinesEndpoint[];
 export declare function normalizeEndpoint(method: string, path: string): string;
 /** The contract as a set of normalized `METHOD path` keys. */
 export declare function contractKeys(): Set<string>;
+/**
+ * The flaps endpoints the release activities (./machine-release.ts, #2736)
+ * add beyond the applier's: getting one Machine back, exec (a migration),
+ * restart and stop. The applier's own contract above stays exec-free; these
+ * are the site steps', and the docker-gated coverage test holds the pinned
+ * mudflaps to them the same way.
+ */
+export declare const MACHINE_RELEASE_CONTRACT: readonly MachinesEndpoint[];
 //# sourceMappingURL=machines-contract.d.ts.map

package/dist/op/activities/machines-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"machines-contract.d.ts","sourceRoot":"","sources":["../../../src/op/activities/machines-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,qDAAqD;AACrD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC1C,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,gBAAgB,EA8B/C,CAAC;AAEX,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,8DAA8D;AAC9D,wBAAgB,YAAY,IAAI,GAAG,CAAC,MAAM,CAAC,CAE1C"}
+{"version":3,"file":"machines-contract.d.ts","sourceRoot":"","sources":["../../../src/op/activities/machines-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,qDAAqD;AACrD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC1C,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,gBAAgB,EA8B/C,CAAC;AAEX,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,8DAA8D;AAC9D,wBAAgB,YAAY,IAAI,GAAG,CAAC,MAAM,CAAC,CAE1C;AAED;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,gBAAgB,EAQtD,CAAC"}

package/dist/op/activities/machines-fake.d.ts

@@ -0,0 +1,55 @@
+/**
+ * An in-memory Fly Machines (flaps) API, as a {@link FlyHttp} (#2736).
+ *
+ * The twin of ./sprites-fake.ts for the Machines side: the endpoints the
+ * applier (./fly-apply.ts) and the release activities (./machine-release.ts)
+ * call, answered from memory with the response shapes flaps and mudflaps use.
+ * Unit tests inject it where the default client would reach the network; the
+ * docker-gated tests run the same activities against the pinned mudflaps.
+ * It runs nothing; ./machines-local.ts is the opt-in mode that runs each
+ * started Machine's files and command on this host (#2831).
+ *
+ * Not an activity: nothing in ./index.ts exports it, so `loadActivities`
+ * never binds it.
+ */
+import type { FlyHttp } from "./fly-apply.js";
+/** One Machine the fake holds. */
+export interface FakeMachine {
+    id: string;
+    name: string;
+    state: string;
+    instance_id: string;
+    config: Record<string, unknown> & {
+        metadata?: Record<string, string>;
+    };
+}
+/** What an `exec` answers: the Machines API's exec envelope. */
+export interface FakeExecResult {
+    exit_code: number;
+    stdout?: string;
+    stderr?: string;
+}
+export interface MachinesFake {
+    http: FlyHttp;
+    apps: Set<string>;
+    machines: Map<string, FakeMachine[]>;
+    /** Every exec, in order: the app, the machine id and the command. */
+    execs: Array<{
+        app: string;
+        id: string;
+        command: string[];
+    }>;
+    /** Every call, as `METHOD path` (no base, no query). */
+    calls: string[];
+    /** The live machine named `name` in `app`, if any. */
+    machine(app: string, name: string): FakeMachine | undefined;
+}
+export interface MachinesFakeOptions {
+    /** Answer an exec. Default: exit 0 with no output. The running mode (./machines-local.ts) answers it by running the command. */
+    exec?: (app: string, machine: FakeMachine, command: string[]) => FakeExecResult | Promise<FakeExecResult>;
+    /** The state a created or updated machine settles in. Default `started`. */
+    settle?: (machine: FakeMachine) => string;
+}
+/** A fresh in-memory flaps. */
+export declare function createMachinesFake(options?: MachinesFakeOptions): MachinesFake;
+//# sourceMappingURL=machines-fake.d.ts.map

package/dist/op/activities/machines-fake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"machines-fake.d.ts","sourceRoot":"","sources":["../../../src/op/activities/machines-fake.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,kCAAkC;AAClC,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;CACzE;AAED,gEAAgE;AAChE,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAClB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IACrC,qEAAqE;IACrE,KAAK,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAC7D,wDAAwD;IACxD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,sDAAsD;IACtD,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;CAC7D;AAED,MAAM,WAAW,mBAAmB;IAClC,gIAAgI;IAChI,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC1G,4EAA4E;IAC5E,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,MAAM,CAAC;CAC3C;AAOD,+BAA+B;AAC/B,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,YAAY,CA4GlF"}

package/dist/op/activities/machines-local-cli.d.ts

@@ -0,0 +1,20 @@
+/**
+ * A local Fly Machines API that runs its Machines (#2831), as a command:
+ *
+ *   tsx node_modules/@intentius/chant-lexicon-fly/src/op/activities/machines-local-cli.ts \
+ *     [--listen 4280] [--root <dir>] [--publish <port> | --publish <name>=<port> ...] [--log <file>]
+ *
+ * Point the release activities at it with `FLY_FLAPS_BASE_URL=http://127.0.0.1:4280`.
+ * `--publish 8080` publishes every Machine's service on 8080; `--publish web=8080`
+ * publishes the Machine named `web` there; with no `--publish` each Machine gets a free
+ * port, which the event lines say. SIGINT or SIGTERM stops every Machine's process
+ * and exits. See ./machines-local.ts.
+ */
+import { type LocalPublish } from "./machines-local.js";
+export declare function parseArgs(argv: string[]): {
+    port: number;
+    root?: string;
+    publish?: LocalPublish;
+    log?: string;
+};
+//# sourceMappingURL=machines-local-cli.d.ts.map

package/dist/op/activities/machines-local-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"machines-local-cli.d.ts","sourceRoot":"","sources":["../../../src/op/activities/machines-local-cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEzE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAyB/G"}

package/dist/op/activities/machines-local.d.ts

@@ -0,0 +1,107 @@
+/**
+ * A local Fly Machines API that runs its Machines (#2831).
+ *
+ * ./machines-fake.ts answers the flaps endpoints from memory and runs nothing,
+ * and so does mudflaps. That is what unit tests want, and it stays the
+ * default. This module is the opt-in running mode: the same in-memory API,
+ * with each started Machine run as a process on this host, so a release that
+ * puts a source tree on a Machine (`config.files` plus `init.cmd`) can be
+ * checked over HTTP.
+ *
+ * For each Machine the fake holds in state `started`:
+ *
+ *   - `config.files` are written at their `guest_path` (under `root` when one
+ *     is given), and the files an earlier instance wrote are removed first, as
+ *     a Machine's root filesystem starts again from its image;
+ *   - `config.mounts` are directories that outlive instances (a Volume);
+ *   - `init.exec`, or `init.entrypoint` then `init.cmd`, runs with
+ *     `config.env`, and an `exec` (a migration) runs its command with the same
+ *     env;
+ *   - a service's `internal_port` is published on a host port: when the
+ *     Machine's env sets `PORT` to an `internal_port`, the process gets the
+ *     host port instead, since every Machine here shares the host's network.
+ *
+ * No image is pulled: the command runs on this host's binaries (a Node app
+ * runs on this host's Node).
+ *
+ * A create or an update (a new `instance_id`) starts the process again, a
+ * `restart` restarts it, a `stop` or a delete stops it, and a process that
+ * exits on its own leaves its Machine `stopped`. Each call answers only after
+ * that is done, and a started process is given until its published port
+ * accepts a connection, so the next call (a migration's exec, a health check)
+ * finds the files and the server.
+ *
+ * Processes run in their own process group. `close()` stops them all
+ * (SIGTERM, then SIGKILL); if the host process exits or is ended by SIGINT,
+ * SIGTERM or SIGHUP first, they are killed with it. Only a SIGKILL of the host
+ * process can leave them running.
+ */
+import { type FakeMachine, type MachinesFake, type MachinesFakeOptions } from "./machines-fake.js";
+/** Where a Machine's service is published: one port for every Machine, a port per Machine name (or `app/name`), or a function. */
+export type LocalPublish = number | Record<string, number> | ((app: string, machine: FakeMachine) => number | undefined);
+export interface LocalMachinesOptions {
+    /**
+     * A host directory the Machines' guest paths are placed under: `/srv/app`
+     * becomes `<root>/srv/app`, in the files written, the mounts, and the
+     * command, exec and env strings that name those paths. Default: none, so a
+     * guest path is the same path on this host (a container or a box made for it).
+     */
+    root?: string;
+    /** The host port a Machine's service is published on. Default: a free port per Machine, kept for its name. */
+    publish?: LocalPublish;
+    /** A file the processes' stdout and stderr are appended to. Default: this process's stderr. */
+    log?: string;
+    /** How long a started process is given to accept a connection on its published port. Default 15s. */
+    readyTimeoutMs?: number;
+    /** How long a stopped process is given after SIGTERM before SIGKILL. Default 5s. */
+    stopTimeoutMs?: number;
+    /** What happens, one line at a time (starts, stops, execs). Default: nothing is said. */
+    onEvent?: (line: string) => void;
+    /**
+     * Kill the processes when this process gets SIGINT, SIGTERM or SIGHUP, then raise the signal again if nothing
+     * else handles it. Default true; a caller that handles those signals itself (and calls `close()`) passes false.
+     */
+    handleSignals?: boolean;
+    /** Passed to the fake: the state a created or updated Machine settles in. */
+    settle?: MachinesFakeOptions["settle"];
+}
+/** A Machine's process, as {@link LocalMachines.processes} reports it. */
+export interface LocalProcess {
+    app: string;
+    id: string;
+    name: string;
+    instance: string;
+    pid: number | undefined;
+    /** The host port its service is published on, when its env names one. */
+    port: number | undefined;
+}
+export interface LocalMachines extends MachinesFake {
+    /** `http://127.0.0.1:<port>` for the running Machine `name` in `app`, when its service is published. */
+    endpoint(app: string, name: string): string | undefined;
+    /** The processes running now. */
+    processes(): LocalProcess[];
+    /** Stop every process and remove its files. Mounts are kept. */
+    close(): Promise<void>;
+}
+/** An in-memory Machines API that runs each started Machine on this host. See the module header. */
+export declare function createLocalMachines(options?: LocalMachinesOptions): LocalMachines;
+export interface ServeLocalMachinesOptions extends LocalMachinesOptions {
+    /** The port the Machines API listens on. Default 4280, mudflaps' port; 0 picks a free one. */
+    port?: number;
+    /** Default 127.0.0.1. */
+    host?: string;
+}
+export interface ServedLocalMachines {
+    /** The flaps base URL, for `FLY_FLAPS_BASE_URL` or an `endpoint` argument. */
+    url: string;
+    machines: LocalMachines;
+    /** Stop every Machine's process, then the server. */
+    close(): Promise<void>;
+}
+/**
+ * Serve {@link createLocalMachines} over HTTP, where the release activities
+ * reach it through `FLY_FLAPS_BASE_URL`. `GET /_mudflaps/health` answers 200,
+ * as mudflaps' health check does.
+ */
+export declare function serveLocalMachines(options?: ServeLocalMachinesOptions): Promise<ServedLocalMachines>;
+//# sourceMappingURL=machines-local.d.ts.map

package/dist/op/activities/machines-local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"machines-local.d.ts","sourceRoot":"","sources":["../../../src/op/activities/machines-local.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAQH,OAAO,EAA2C,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEzI,kIAAkI;AAClI,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,KAAK,MAAM,GAAG,SAAS,CAAC,CAAC;AAEzH,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8GAA8G;IAC9G,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,+FAA+F;IAC/F,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qGAAqG;IACrG,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oFAAoF;IACpF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yFAAyF;IACzF,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;CACxC;AAED,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,yEAAyE;IACzE,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,wGAAwG;IACxG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACxD,iCAAiC;IACjC,SAAS,IAAI,YAAY,EAAE,CAAC;IAC5B,gEAAgE;IAChE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAwDD,oGAAoG;AACpG,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB,GAAG,aAAa,CAqOrF;AAED,MAAM,WAAW,yBAA0B,SAAQ,oBAAoB;IACrE,8FAA8F;IAC9F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,8EAA8E;IAC9E,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,aAAa,CAAC;IACxB,qDAAqD;IACrD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAiC9G"}

package/dist/op/activities/sprite-fs.d.ts

@@ -8,8 +8,12 @@
  * read/write move raw file bytes in the body (not JSON), so these use a small
  * raw HTTP client (`SpritesRawHttp`) rather than the JSON `SpritesHttp` the
  * lifecycle activities use; path/mode/mkdir/recursive ride as query params.
- * Endpoint + bearer resolution mirror `sprites.ts` — an explicit `endpoint` /
- * `token` wins, then `SPRITES_BASE_URL` / `SPRITES_API_TOKEN`.
+ * Endpoint + bearer resolution go through `sprites.ts`'s shared resolvers
+ * (`resolveSpritesEndpoint`/`resolveSpritesToken`) — an explicit `endpoint` /
+ * `token` wins, then `SPRITES_BASE_URL`/`SPRITES_API_URL`, then
+ * `SPRITES_API_TOKEN`/its `SPRITE_TOKEN` alias (#2711, #2765: this module
+ * used to read `SPRITES_API_TOKEN` directly, missing the alias the other
+ * Sprites activities honor).
  */
 /**
  * Build a `/v1/sprites/{id}/fs/{op}?...` URL. `params` values that are undefined
@@ -29,7 +33,12 @@ export type SpritesRawHttp = (method: string, url: string, body?: string, header
  * Default `fetch`-based raw client. Sends the body as-is with an
  * `application/octet-stream` content-type and `Authorization: Bearer <token>`
  * when a token is set (real Sprites); the fake ignores the token. The token
- * defaults to `SPRITES_API_TOKEN` at call time. `fetchImpl` is injectable.
+ * resolves through `resolveSpritesToken` at call time — `SPRITES_API_TOKEN`,
+ * then its `SPRITE_TOKEN` alias (#2711, #2765) — the same resolver
+ * `sprites.ts`'s `defaultSpritesHttp` uses, so every fs activity
+ * (`spriteWriteFile`, `spriteReadFile`, `spriteListDir`, `spriteRemove`)
+ * authenticates the same way the lifecycle activities do. `fetchImpl` is
+ * injectable.
  */
 export declare function defaultSpritesRawHttp(token?: string, fetchImpl?: typeof fetch): SpritesRawHttp;
 export interface SpriteWriteFileArgs {

package/dist/op/activities/sprite-fs.d.ts.map

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

package/dist/op/activities/sprite-service-converge.d.ts

@@ -0,0 +1,107 @@
+/**
+ * A sprite's services as resources a `ConvergeOp` observes and converges
+ * (#2778).
+ *
+ * A box runs its app, hud, door and site as services a supervisor keeps
+ * running: sprite-env on a sprite, and a stand-in with the same command line
+ * elsewhere. No lexicon declares them, so a ConvergeOp can't observe them
+ * through an environment. It can through an observer step:
+ *
+ * - `spriteServicesObserve` reads the supervisor's list and probes each
+ *   declared service's health URL, and returns one verdict per service,
+ *   `in-sync`, `drifted` or `unknown`: the `ResourceObservation` a
+ *   `ConvergeOp({ observe })` evaluates its rules against, once per service.
+ * - `spriteServiceRestart` restarts one service through the supervisor and
+ *   waits for its health URL. It is the step of the Op a rule dispatches; the
+ *   service is the one the rule fired for, which the dispatched run reads
+ *   from `CHANT_CONVERGE_RESOURCE`.
+ *
+ * Both work in one of two ways. With no sprite `id`, they run inside the
+ * sprite and call `sprite-env services` (found on PATH or in /.sprite/bin,
+ * or at `spriteEnv`). With an `id`, they go through the Sprites API
+ * (`spriteServiceList`, `spriteServiceStop` and `spriteServiceStart`).
+ */
+import type { SpritesHttp } from "./sprites.js";
+/** One service a box declares. */
+export interface DeclaredSpriteService {
+    name: string;
+    /** A URL that answers 200 while the service works. Without one, the supervisor's state decides. */
+    health?: string;
+    /** Not defined yet is not drift: the service is left out until it exists (a site before its first release). */
+    optional?: boolean;
+}
+interface Via {
+    /** The sprite, for the Sprites API. Without it, `sprite-env` inside the sprite. */
+    id?: string;
+    /** The `sprite-env` binary. Default: the one on PATH, else /.sprite/bin/sprite-env. */
+    spriteEnv?: string;
+    endpoint?: string;
+    token?: string;
+}
+export interface SpriteServicesObserveArgs extends Via {
+    /** The declared services. */
+    services?: DeclaredSpriteService[];
+    /** A JSON file of `{ services: [...] }`, relative to the working directory, read on each tick. */
+    servicesFile?: string;
+    /** Health probes before a service counts as drifted. Default 3. */
+    probes?: number;
+    /** Time between probes, ms. Default 1000. */
+    probeIntervalMs?: number;
+}
+export interface SpriteServicesObserveResult {
+    resources: {
+        name: string;
+        status: "in-sync" | "drifted" | "unknown";
+        detail: string;
+    }[];
+    /** Optional services that aren't defined yet. */
+    skipped: string[];
+}
+export interface SpriteServiceRestartArgs extends Via {
+    /** The service. Default: the resource a ConvergeOp dispatched this run for (`CHANT_CONVERGE_RESOURCE`). */
+    name?: string;
+    /** Its health URL. Default: the one `services` or `servicesFile` declares for it. */
+    health?: string;
+    services?: DeclaredSpriteService[];
+    servicesFile?: string;
+    /** How long to wait for the health URL after the restart, ms. Default 60000. */
+    waitMs?: number;
+}
+export interface SpriteServiceRestartResult {
+    name: string;
+    /** Whether its health URL answered, or null when it declares none. */
+    healthy: boolean | null;
+}
+/** The services declared inline and in `servicesFile`, inline first. */
+export declare function declaredServices(args: {
+    services?: DeclaredSpriteService[];
+    servicesFile?: string;
+}, cwd?: string): DeclaredSpriteService[];
+/** The sprite-env binary, or null when there is none. */
+export declare function findSpriteEnv(explicit?: string, env?: NodeJS.ProcessEnv): string | null;
+/**
+ * `sprite-env services list` as name to state. A sprite's sprite-env prints
+ * JSON (an array of services with `state.status`); a stand-in may print a
+ * tab-separated table whose second column is the state. Pure.
+ */
+export declare function parseServicesList(text: string): Map<string, string | null>;
+/** One GET of a health URL: true on 200. */
+export declare function probeHealth(url: string, signal?: AbortSignal): Promise<boolean>;
+/**
+ * Observe the declared services: one verdict each, for a ConvergeOp's rules.
+ * A service the supervisor doesn't have, or has stopped, is drifted; one
+ * with a health URL is in sync when the URL answers 200 within `probes`
+ * tries and drifted when it doesn't; one without is in sync while it runs.
+ * When the supervisor can't be read, every service is unknown, and unknown
+ * never remediates.
+ */
+export declare function spriteServicesObserve(args: SpriteServicesObserveArgs, signal?: AbortSignal, http?: SpritesHttp): Promise<SpriteServicesObserveResult>;
+/**
+ * Restart one service through its supervisor and wait for its health URL.
+ * The service is `name`, or the resource the ConvergeOp's rule fired for.
+ * Throws when neither names one, when the supervisor refuses, or when the
+ * service does not answer its health URL within `waitMs`.
+ */
+export declare function spriteServiceRestart(args: SpriteServiceRestartArgs, signal?: AbortSignal, http?: SpritesHttp): Promise<SpriteServiceRestartResult>;
+export {};
+//# sourceMappingURL=sprite-service-converge.d.ts.map

package/dist/op/activities/sprite-service-converge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprite-service-converge.d.ts","sourceRoot":"","sources":["../../../src/op/activities/sprite-service-converge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAY7C,kCAAkC;AAClC,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,mGAAmG;IACnG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+GAA+G;IAC/G,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,UAAU,GAAG;IACX,mFAAmF;IACnF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,uFAAuF;IACvF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,yBAA0B,SAAQ,GAAG;IACpD,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACnC,kGAAkG;IAClG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzF,iDAAiD;IACjD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,wBAAyB,SAAQ,GAAG;IACnD,2GAA2G;IAC3G,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACzB;AAID,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,QAAQ,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,SAAgB,GAAG,qBAAqB,EAAE,CAWlJ;AAED,yDAAyD;AACzD,wBAAgB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,GAAG,IAAI,CAMpG;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAoB1E;AAaD,4CAA4C;AAC5C,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CASrF;AAID;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,yBAAyB,EAC/B,MAAM,CAAC,EAAE,WAAW,EACpB,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,2BAA2B,CAAC,CAgDtC;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,wBAAwB,EAC9B,MAAM,CAAC,EAAE,WAAW,EACpB,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,0BAA0B,CAAC,CAyBrC"}