@intentius/chant-lexicon-fly 0.16.0

package/dist/import/live-export.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Pure export helpers for the fly lexicon — strip live flaps state to the
+ * authored shape and build import IR from it. All flaps I/O stays in the caller
+ * (`../export-resources`); this module is deterministic and unit-testable.
+ *
+ * The strip mirrors the read-only field lists the parser drops, so a live
+ * machine/app reaches the same declared shape a user would have written. Machine
+ * ownership is a per-resource marker (`managed-by: chant` in `config.metadata`,
+ * read via `isChantOwned`); the app carries no marker, so under the `owned`
+ * filter its ownership is inferred at the app boundary (an app is chant-managed
+ * when one of its machines is), and the limitation is logged rather than
+ * silently returning everything — the seam contract, matching gcp/aws.
+ *
+ * `verbatim` is inert for fly (the core contract permits this for targets whose
+ * importable surface is already the declared shape): the App/Machine
+ * constructors accept only the writable surface, so server-written fields are
+ * not constructor parameters and cannot round-trip into the generated code. The
+ * option is accepted for signature parity.
+ */
+import type { ExportedTemplate, ResourceSelector } from "@intentius/chant/lexicon";
+import { type FlapsMachine } from "../op/activities/fly-apply.js";
+/** Drop server-written read-only machine fields to reach the authored shape. Returns a new object. */
+export declare function stripMachineServerFields(machine: Record<string, unknown>): Record<string, unknown>;
+/** Drop server-written read-only app fields, keeping `name`/`org_slug`. Returns a new object. */
+export declare function stripAppServerFields(app: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Build export IR from one app's live flaps state. Reuses {@link FlyParser} as
+ * the single wire→authoring mapping authority by feeding it a cleaned
+ * app-with-machines bundle.
+ *
+ * `opts.owned` keeps only machines carrying the chant marker, and includes the
+ * app only when it is chant-managed (a machine is). `opts.verbatim` keeps server
+ * fields. Pure: logging is delegated to `opts.onBoundaryInference`, which the
+ * I/O caller wires to a single warn.
+ */
+export declare function buildExportFromApp(app: Record<string, unknown> | undefined, machines: FlapsMachine[], opts?: {
+    verbatim?: boolean;
+    selector?: ResourceSelector;
+    owned?: boolean;
+    onBoundaryInference?: () => void;
+}): ExportedTemplate;
+//# sourceMappingURL=live-export.d.ts.map

package/dist/import/live-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-export.d.ts","sourceRoot":"","sources":["../../src/import/live-export.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACnF,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAW7E,sGAAsG;AACtG,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIlG;AAED,iGAAiG;AACjG,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQ1F;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACxC,QAAQ,EAAE,YAAY,EAAE,EACxB,IAAI,GAAE;IACJ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mBAAmB,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B,GACL,gBAAgB,CAqClB"}

package/dist/import/parser.d.ts

@@ -0,0 +1,40 @@
+/**
+ * flaps JSON template parser.
+ *
+ * Turns Fly Machines API ("flaps") JSON into the import IR for conversion to
+ * chant TypeScript. Three input shapes are accepted, all mapped to the authoring
+ * surface (the writable fields a user would have declared):
+ *
+ *   1. The #738 serializer plan — `{ <entity>: { endpoint, method, body } }`.
+ *      `/v1/apps` bodies become `App`s; `.../machines` bodies become `Machine`s.
+ *   2. A machines listing (an array) or an app-with-machines bundle
+ *      (`{ ...appFields, machines: [...] }`) — an `App` plus its `Machine`s.
+ *   3. A single machine (`{ name, region, config }`) or a single app
+ *      (`{ app_name }` / the `GET /v1/apps/{app}` shape).
+ *
+ * flaps wire field names are mapped back to the authoring surface: an app's
+ * `app_name` becomes the `App`'s `name`, and server-written read-only machine
+ * fields (id, state, instance_id, ...) are dropped so the IR is the declared
+ * shape. `logicalId` is the app/machine name (the generator camelCases it into a
+ * variable).
+ */
+import type { TemplateParser, TemplateIR } from "@intentius/chant/import/parser";
+import { BaseValueParser } from "@intentius/chant/import/base-parser";
+export declare const APP_TYPE = "Fly::Machines::App";
+export declare const MACHINE_TYPE = "Fly::Machines::Machine";
+/** Server-written read-only machine fields — never part of the authored shape. */
+export declare const MACHINE_SERVER_FIELDS: string[];
+/** Server-written read-only app fields — never part of the authored shape. */
+export declare const APP_SERVER_FIELDS: string[];
+export declare class FlyParser extends BaseValueParser implements TemplateParser {
+    protected dispatchIntrinsic(_key: string, _value: unknown, _obj: Record<string, unknown>): unknown | null;
+    parse(input: string): TemplateIR;
+    /** Map one serializer-plan request to a resource by its endpoint. */
+    private resourceFromRequest;
+    private looksLikeApp;
+    /** An `App` resource. flaps `app_name` (create body) or `name` (GET) → `name`. */
+    private appResource;
+    /** A `Machine` resource, stripped of server-written read-only fields. */
+    private machineResource;
+}
+//# sourceMappingURL=parser.d.ts.map

package/dist/import/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/import/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EAEX,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAGtE,eAAO,MAAM,QAAQ,uBAAuB,CAAC;AAC7C,eAAO,MAAM,YAAY,2BAA2B,CAAC;AAErD,kFAAkF;AAClF,eAAO,MAAM,qBAAqB,UAajC,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,UAO7B,CAAC;AAMF,qBAAa,SAAU,SAAQ,eAAgB,YAAW,cAAc;IACtE,SAAS,CAAC,iBAAiB,CACzB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,GAAG,IAAI;IAKjB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;IAiDhC,qEAAqE;IACrE,OAAO,CAAC,mBAAmB;IAkB3B,OAAO,CAAC,YAAY;IAIpB,kFAAkF;IAClF,OAAO,CAAC,WAAW;IAuBnB,yEAAyE;IACzE,OAAO,CAAC,eAAe;CAexB"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { flyPlugin } from "./plugin.js";
+export { flySerializer } from "./serializer.js";
+export { Fly, Region, OrgSlug, AppName, PseudoParameter } from "./pseudo.js";
+export { FLY_METADATA_OWNERSHIP_KEYS } from "./ownership.js";
+export { flyDeploy, flapsUp, flapsDown, flyApplyStep, LOCAL_FLAPS_ENDPOINT } from "./composites/fly-deploy.js";
+export type { FlyDeployOpts, FlyApplyStepOpts, FlapsStepOpts } from "./composites/fly-deploy.js";
+export * from "./generated/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGrC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAI7C,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG1E,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAK1D,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC5G,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAK9F,cAAc,mBAAmB,CAAC"}

package/dist/integrity.json

@@ -0,0 +1,9 @@
+{
+  "algorithm": "sha256",
+  "artifacts": {
+    "manifest.json": "fcc2496380c816d45afe24ae51a64d54a856820179f16f7f61d4ff21e566738e",
+    "meta.json": "e46e65ba7544fafc6dbb3fd48b841904b5ae6f7cb4d517a940ed68b01626c097",
+    "types/index.d.ts": "ec573230bc00413137871d6f1470e027083231dfd188b69b2517b20c3317a6b6"
+  },
+  "composite": "5a1f375f50953512d171047c55a13bcaa03f7ce8fc10a79bc17d5806f5ee5436"
+}

package/dist/lint/post-synth/fly-helpers.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Shared helpers for the fly post-synth checks. Not a check itself, so the
+ * generated barrel skips it (the scanner only picks up exported PostSynthChecks).
+ */
+/**
+ * Read an entity or property's constructor props. Nested Declarables
+ * (MachineConfig, MachineMount, Volume) stash their args under a non-enumerable
+ * `props`; a plain inline object carries them directly. Handle both so a check
+ * behaves the same whether the user authored `config: { image }` or
+ * `config: new MachineConfig({ image })`.
+ */
+export declare function readProps(value: unknown): Record<string, unknown>;
+/** The entityType of a declarable, or undefined. */
+export declare function entityTypeOf(value: unknown): string | undefined;
+//# sourceMappingURL=fly-helpers.d.ts.map

package/dist/lint/post-synth/fly-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fly-helpers.d.ts","sourceRoot":"","sources":["../../../src/lint/post-synth/fly-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOjE;AAED,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAE/D"}

package/dist/lint/post-synth/fly010-machine-requires-image.d.ts

@@ -0,0 +1,10 @@
+/**
+ * FLY010: Machine config must specify an image.
+ *
+ * A Machine cannot boot without a container image. The Machines API rejects a
+ * create request whose config omits `image`, so catch it at synth time with a
+ * clearer message.
+ */
+import type { PostSynthCheck } from "@intentius/chant/lint/post-synth";
+export declare const fly010: PostSynthCheck;
+//# sourceMappingURL=fly010-machine-requires-image.d.ts.map

package/dist/lint/post-synth/fly010-machine-requires-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fly010-machine-requires-image.d.ts","sourceRoot":"","sources":["../../../src/lint/post-synth/fly010-machine-requires-image.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAyC,MAAM,kCAAkC,CAAC;AAG9G,eAAO,MAAM,MAAM,EAAE,cA2BpB,CAAC"}

package/dist/lint/post-synth/fly011-mount-references-declared-volume.d.ts

@@ -0,0 +1,12 @@
+/**
+ * FLY011: A machine mount must reference a declared volume.
+ *
+ * Every machine `config.mounts[].volume` must resolve to a `Volume` declared in
+ * the stack. A mount pointing at a volume that does not exist is rejected at
+ * apply time, so catch it at synth. This is a whole-stack check: it reads all
+ * entities in the build (`ctx.entities`), so the mount and the Volume can be
+ * declared in different files.
+ */
+import type { PostSynthCheck } from "@intentius/chant/lint/post-synth";
+export declare const fly011: PostSynthCheck;
+//# sourceMappingURL=fly011-mount-references-declared-volume.d.ts.map

package/dist/lint/post-synth/fly011-mount-references-declared-volume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fly011-mount-references-declared-volume.d.ts","sourceRoot":"","sources":["../../../src/lint/post-synth/fly011-mount-references-declared-volume.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAyC,MAAM,kCAAkC,CAAC;AAM9G,eAAO,MAAM,MAAM,EAAE,cA4CpB,CAAC"}

package/dist/lint/post-synth/index.d.ts

@@ -0,0 +1,3 @@
+import type { PostSynthCheck } from "@intentius/chant/lint/post-synth";
+export declare const postSynthChecks: PostSynthCheck[];
+//# sourceMappingURL=index.d.ts.map

package/dist/lint/post-synth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lint/post-synth/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAIvE,eAAO,MAAM,eAAe,EAAE,cAAc,EAG3C,CAAC"}

package/dist/lint/rules/guest-sizing.d.ts

@@ -0,0 +1,9 @@
+import type { LintRule } from "@intentius/chant/lint/rule";
+/**
+ * FLY002: Sane guest sizing
+ *
+ * A guest's `cpu_kind`, `cpus`, and `memory_mb` must be a valid combination per
+ * Fly's guest presets. An invalid combination is rejected at apply time.
+ */
+export declare const guestSizingRule: LintRule;
+//# sourceMappingURL=guest-sizing.d.ts.map

package/dist/lint/rules/guest-sizing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guest-sizing.d.ts","sourceRoot":"","sources":["../../../src/lint/rules/guest-sizing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAA+B,MAAM,4BAA4B,CAAC;AAyCxF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,QAoD7B,CAAC"}

package/dist/lint/rules/index.d.ts

@@ -0,0 +1,7 @@
+import type { LintRule } from "@intentius/chant/lint/rule";
+export { validRegionRule } from "./valid-region.js";
+export { guestSizingRule } from "./guest-sizing.js";
+export { noSecretLiteralsRule } from "./no-secret-literals.js";
+/** All lint rules provided by the fly lexicon. */
+export declare const rules: LintRule[];
+//# sourceMappingURL=index.d.ts.map

package/dist/lint/rules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lint/rules/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAK3D,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,kDAAkD;AAClD,eAAO,MAAM,KAAK,EAAE,QAAQ,EAI3B,CAAC"}

package/dist/lint/rules/no-secret-literals.d.ts

@@ -0,0 +1,13 @@
+import type { LintRule } from "@intentius/chant/lint/rule";
+/**
+ * FLY004: No secret literals in machine config
+ *
+ * Flags secret values written inline in config (e.g. an env value under a
+ * credential-looking key). Secrets belong in `secrets` (apply-only) or a
+ * reference. The heuristic is conservative: it fires only when the property
+ * name looks like a credential AND the value is a plain string literal that is
+ * not a reference/placeholder, so a `secrets` reference (an identifier or
+ * `$FOO` placeholder) is not flagged.
+ */
+export declare const noSecretLiteralsRule: LintRule;
+//# sourceMappingURL=no-secret-literals.d.ts.map

package/dist/lint/rules/no-secret-literals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-secret-literals.d.ts","sourceRoot":"","sources":["../../../src/lint/rules/no-secret-literals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAA+B,MAAM,4BAA4B,CAAC;AAgBxF;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAwClC,CAAC"}

package/dist/lint/rules/valid-region.d.ts

@@ -0,0 +1,9 @@
+import type { LintRule } from "@intentius/chant/lint/rule";
+/**
+ * FLY001: Valid Fly region
+ *
+ * A machine (or volume/IP) `region` must be a known Fly region code. An unknown
+ * region is rejected at apply time; catch it at build with a clearer message.
+ */
+export declare const validRegionRule: LintRule;
+//# sourceMappingURL=valid-region.d.ts.map

package/dist/lint/rules/valid-region.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"valid-region.d.ts","sourceRoot":"","sources":["../../../src/lint/rules/valid-region.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAA+B,MAAM,4BAA4B,CAAC;AAoBxF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,QA+B7B,CAAC"}

package/dist/lsp/completions.d.ts

@@ -0,0 +1,9 @@
+import type { CompletionContext, CompletionItem } from "@intentius/chant/lsp/types";
+/**
+ * Provide LSP completions for fly resources.
+ *
+ * TODO: Build a LexiconIndex from your generated lexicon data
+ * and delegate to lexiconCompletions().
+ */
+export declare function completions(ctx: CompletionContext): CompletionItem[];
+//# sourceMappingURL=completions.d.ts.map

package/dist/lsp/completions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completions.d.ts","sourceRoot":"","sources":["../../src/lsp/completions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAGpF;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,iBAAiB,GAAG,cAAc,EAAE,CAIpE"}

package/dist/lsp/hover.d.ts

@@ -0,0 +1,9 @@
+import type { HoverContext, HoverInfo } from "@intentius/chant/lsp/types";
+/**
+ * Provide LSP hover information for fly resources.
+ *
+ * TODO: Build a LexiconIndex from your generated lexicon data
+ * and delegate to lexiconHover().
+ */
+export declare function hover(ctx: HoverContext): HoverInfo | undefined;
+//# sourceMappingURL=hover.d.ts.map

package/dist/lsp/hover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hover.d.ts","sourceRoot":"","sources":["../../src/lsp/hover.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAG1E;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,SAAS,GAAG,SAAS,CAI9D"}

package/dist/manifest.json

@@ -0,0 +1,4 @@
+{
+  "name": "fly",
+  "version": "0.0.1"
+}

package/dist/meta.json

@@ -0,0 +1,285 @@
+{
+  "App": {
+    "resourceType": "Fly::Machines::App",
+    "kind": "resource",
+    "lexicon": "fly"
+  },
+  "Certificate": {
+    "resourceType": "Fly::Machines::Certificate",
+    "kind": "resource",
+    "lexicon": "fly"
+  },
+  "ContainerConfig": {
+    "resourceType": "Fly::Machines::ContainerConfig",
+    "kind": "property",
+    "lexicon": "fly"
+  },
+  "ContainerDependency": {
+    "resourceType": "Fly::Machines::ContainerDependency",
+    "kind": "property",
+    "lexicon": "fly"
+  },
+  "ContainerHealthcheck": {
+    "resourceType": "Fly::Machines::ContainerHealthcheck",
+    "kind": "property",
+    "lexicon": "fly"
+  },
+  "DNSConfig": {
+    "resourceType": "Fly::Machines::DNSConfig",
+    "kind": "property",
+    "lexicon": "fly"
+  },
+  "DnsForwardRule": {
+    "resourceType": "Fly::Machines::DnsForwardRule",
+    "kind": "property",
+    "lexicon": "fly"
+  },
+  "DnsOption": {
+    "resourceType": "Fly::Machines::DnsOption",
+    "kind": "property",
+    "lexicon": "fly"
+  },
+  "EnvFrom": {
+    "resourceType": "Fly::Machines::EnvFrom",
+    "kind": "property",
+    "lexicon": "fly",
+    "constraints": {
+      "field_ref": {
+        "enum": [
+          "id",
+          "version",
+          "app_name",
+          "private_ip",
+          "region",
+          "image"
+        ]
+      }
+    }
+  },
+  "ExecHealthcheck": {
+    "resourceType": "Fly::Machines::ExecHealthcheck",
+    "kind": "property",
+    "lexicon": "fly"
+  },
+  "File": {
+    "resourceType": "Fly::Machines::File",
+    "kind": "property",
+    "lexicon": "fly"
+  },
+  "HTTPHealthcheck": {
+    "resourceType": "Fly::Machines::HTTPHealthcheck",
+    "kind": "property",
+    "lexicon": "fly"
+  },
+  "HTTPOptions": {
+    "resourceType": "Fly::Machines::HTTPOptions",
+    "kind": "property",
+    "lexicon": "fly"
+  },
+  "HTTPResponseOptions": {
+    "resourceType": "Fly::Machines::HTTPResponseOptions",
+    "kind": "property",
+    "lexicon": "fly"
+  },
+  "IPAddress": {
+    "resourceType": "Fly::Machines::IPAddress",
+    "kind": "resource",
+    "lexicon": "fly"
+  },
+  "Machine": {
+    "resourceType": "Fly::Machines::Machine",
+    "kind": "resource",
+    "lexicon": "fly"
+  },
+  "MachineCacheDrive": {
+    "resourceType": "Fly::Machines::MachineCacheDrive",
+    "kind": "property",
+    "lexicon": "fly"
+  },
+  "MachineCheck": {
+    "resourceType": "Fly::Machines::MachineCheck",
+    "kind": "property",
+    "lexicon": "fly",
+    "constraints": {
+      "kind": {
+        "enum": [
+          "informational",
+          "readiness"
+        ]
+      }
+    }
+  },
+  "MachineConfig": {
+    "resourceType": "Fly::Machines::MachineConfig",
+    "kind": "property",
+    "lexicon": "fly"
+  },
+  "MachineGuest": {
+    "resourceType": "Fly::Machines::MachineGuest",
+    "kind": "property",
+    "lexicon": "fly",
+    "constraints": {
+      "persist_rootfs": {
+        "enum": [
+          "never",
+          "always",
+          "restart"
+        ]
+      }
+    }
+  },
+  "MachineHTTPHeader": {
+    "resourceType": "Fly::Machines::MachineHTTPHeader",
+    "kind": "property",
+    "lexicon": "fly"
+  },
+  "MachineInit": {
+    "resourceType": "Fly::Machines::MachineInit",
+    "kind": "property",
+    "lexicon": "fly"
+  },
+  "MachineMetrics": {
+    "resourceType": "Fly::Machines::MachineMetrics",
+    "kind": "property",
+    "lexicon": "fly"
+  },
+  "MachineMount": {
+    "resourceType": "Fly::Machines::MachineMount",
+    "kind": "property",
+    "lexicon": "fly"
+  },
+  "MachinePort": {
+    "resourceType": "Fly::Machines::MachinePort",
+    "kind": "property",
+    "lexicon": "fly"
+  },
+  "MachineProcess": {
+    "resourceType": "Fly::Machines::MachineProcess",
+    "kind": "property",
+    "lexicon": "fly"
+  },
+  "MachineRestart": {
+    "resourceType": "Fly::Machines::MachineRestart",
+    "kind": "property",
+    "lexicon": "fly",
+    "constraints": {
+      "policy": {
+        "enum": [
+          "no",
+          "always",
+          "on-failure",
+          "spot-price"
+        ]
+      }
+    }
+  },
+  "MachineRootfs": {
+    "resourceType": "Fly::Machines::MachineRootfs",
+    "kind": "property",
+    "lexicon": "fly",
+    "constraints": {
+      "persist": {
+        "enum": [
+          "never",
+          "always",
+          "restart"
+        ]
+      }
+    }
+  },
+  "MachineSecret": {
+    "resourceType": "Fly::Machines::MachineSecret",
+    "kind": "property",
+    "lexicon": "fly"
+  },
+  "MachineService": {
+    "resourceType": "Fly::Machines::MachineService",
+    "kind": "property",
+    "lexicon": "fly",
+    "constraints": {
+      "autostop": {
+        "enum": [
+          "off",
+          "stop",
+          "suspend"
+        ]
+      }
+    }
+  },
+  "MachineServiceCheck": {
+    "resourceType": "Fly::Machines::MachineServiceCheck",
+    "kind": "property",
+    "lexicon": "fly"
+  },
+  "MachineServiceConcurrency": {
+    "resourceType": "Fly::Machines::MachineServiceConcurrency",
+    "kind": "property",
+    "lexicon": "fly"
+  },
+  "MachineSpot": {
+    "resourceType": "Fly::Machines::MachineSpot",
+    "kind": "property",
+    "lexicon": "fly"
+  },
+  "ProxyProtoOptions": {
+    "resourceType": "Fly::Machines::ProxyProtoOptions",
+    "kind": "property",
+    "lexicon": "fly"
+  },
+  "ReplayCache": {
+    "resourceType": "Fly::Machines::ReplayCache",
+    "kind": "property",
+    "lexicon": "fly",
+    "constraints": {
+      "type": {
+        "enum": [
+          "cookie",
+          "header"
+        ]
+      }
+    }
+  },
+  "Secret": {
+    "resourceType": "Fly::Machines::Secret",
+    "kind": "resource",
+    "lexicon": "fly"
+  },
+  "Static": {
+    "resourceType": "Fly::Machines::Static",
+    "kind": "property",
+    "lexicon": "fly"
+  },
+  "StopConfig": {
+    "resourceType": "Fly::Machines::StopConfig",
+    "kind": "property",
+    "lexicon": "fly",
+    "constraints": {
+      "signal": {
+        "enum": [
+          "SIGHUP",
+          "SIGINT",
+          "SIGQUIT",
+          "SIGKILL",
+          "SIGUSR1",
+          "SIGUSR2",
+          "SIGTERM"
+        ]
+      }
+    }
+  },
+  "TCPHealthcheck": {
+    "resourceType": "Fly::Machines::TCPHealthcheck",
+    "kind": "property",
+    "lexicon": "fly"
+  },
+  "TLSOptions": {
+    "resourceType": "Fly::Machines::TLSOptions",
+    "kind": "property",
+    "lexicon": "fly"
+  },
+  "Volume": {
+    "resourceType": "Fly::Machines::Volume",
+    "kind": "resource",
+    "lexicon": "fly"
+  }
+}

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

@@ -0,0 +1,29 @@
+export interface FlapsUpArgs {
+    /** Container name. Default: `chant-mudflaps`. */
+    name?: string;
+    /** Host port mapped to the emulator's `:4280`. Default: `4280`. */
+    port?: number;
+    /** Image. Default: `ghcr.io/intentius/mudflaps:0.3.0`. */
+    image?: string;
+    /** Readiness timeout in ms. Default: `60000`. */
+    timeoutMs?: number;
+    /** Health poll interval in ms. Default: `2000`. */
+    intervalMs?: number;
+}
+export interface FlapsDownArgs {
+    /** Container name to remove. Default: `chant-mudflaps`. */
+    name?: string;
+}
+export declare const flapsExistsCommand: (name: string) => string;
+export declare const flapsRmCommand: (name: string) => string;
+export declare const flapsHealthUrl: (port: number) => string;
+/** The flaps endpoint URL (what `flyApply`'s `FLY_FLAPS_BASE_URL`/`endpoint` points at). */
+export declare const flapsEndpoint: (port: number) => string;
+export declare const flapsRunCommand: (args?: FlapsUpArgs) => string;
+/** Boot a local mudflaps (Fly Machines API emulator) in Docker and return its endpoint. */
+export declare const flapsUp: (args?: FlapsUpArgs, signal?: AbortSignal) => Promise<{
+    endpoint: string;
+}>;
+/** Stop and remove the local mudflaps container (no-op if already gone). */
+export declare const flapsDown: (args?: FlapsDownArgs, signal?: AbortSignal) => Promise<void>;
+//# sourceMappingURL=flaps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flaps.d.ts","sourceRoot":"","sources":["../../../src/op/activities/flaps.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAYD,eAAO,MAAM,kBAAkB,0BAAsB,CAAC;AACtD,eAAO,MAAM,cAAc,0BAAkB,CAAC;AAC9C,eAAO,MAAM,cAAc,0BAAkB,CAAC;AAC9C,4FAA4F;AAC5F,eAAO,MAAM,aAAa,0BAAiB,CAAC;AAC5C,eAAO,MAAM,eAAe,GAAI,OAAM,WAAgB,KAAG,MAAgC,CAAC;AAE1F,2FAA2F;AAC3F,eAAO,MAAM,OAAO,GAAI,OAAM,WAAgB,EAAE,SAAS,WAAW,KAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAC3E,CAAC;AAEzB,4EAA4E;AAC5E,eAAO,MAAM,SAAS,GAAI,OAAM,aAAkB,EAAE,SAAS,WAAW,KAAG,OAAO,CAAC,IAAI,CAC7D,CAAC"}