@alchemy.run/boat 0.0.0-stage → 2.0.0-beta.86

package/lib/Snapshot.js

@@ -0,0 +1,186 @@
+import * as boat from "@distilled.cloud/boat-dev/boat";
+import { Unowned } from "alchemy/AdoptPolicy";
+import { isResolved } from "alchemy/Diff";
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import { sha256Object } from "alchemy/Util/sha256";
+import * as Effect from "effect/Effect";
+import * as Schedule from "effect/Schedule";
+import { SnapshotFailed, SnapshotSetupFailed } from "./Errors.js";
+import { declarable } from "./internal/Declared.js";
+import { boatName, isGeneratedName, ownershipLabels } from "./internal/Ownership.js";
+/**
+ * A warm base for sandboxes: a sandbox set up with your commands and its
+ * disk saved under a name. Sandboxes started from it begin exactly where
+ * the setup left off: packages installed, a repository cloned, a build
+ * cache warm.
+ *
+ * Use a snapshot for work that is too slow to repeat per sandbox. Alchemy
+ * runs the commands in a sandbox of its own, saves it, and deletes the
+ * sandbox. A deploy re-runs the setup only when the commands or the base
+ * change, and a rebuild replaces the declared sandboxes started from it.
+ *
+ * ### Creating a Snapshot
+ * **Example:** A repository with its dependencies installed
+ * ```typescript
+ * export const Golden = Boat.Snapshot("Golden", {
+ *   run: [
+ *     "git clone https://github.com/alchemy-run/alchemy ~/alchemy",
+ *     "cd ~/alchemy && pnpm install",
+ *   ],
+ * });
+ * ```
+ *
+ * **Example:** Layer one snapshot on another
+ * ```typescript
+ * export const Tools = Boat.Snapshot("Tools", { run: ["npm i -g pnpm"] });
+ * export const Golden = Boat.Snapshot("Golden", { from: Tools, run: ["pnpm dlx playwright install"] });
+ * ```
+ *
+ * ### Starting sandboxes from a Snapshot
+ * **Example:** A declared sandbox
+ * ```typescript
+ * export const Box = Boat.Sandbox("Box", { snapshot: Golden });
+ * ```
+ *
+ * **Example:** Sandboxes created at run time
+ * ```typescript
+ * const sandboxes = yield* Boat.CreateSandbox(Golden);
+ * const sandbox = yield* sandboxes.create({ autoStop: "10 minutes" });
+ * ```
+ *
+ * ### Referencing a snapshot the stack doesn't manage
+ * **Example:** Look one up by name
+ * ```typescript
+ * const shared = Boat.Snapshot.lookup({ name: "team-base" });
+ * const sandboxes = yield* Boat.CreateSandbox(shared);
+ * ```
+ *
+ * @resource
+ * @product Snapshot
+ */
+export const Snapshot = declarable()(Resource("Boat.Snapshot"));
+/** Boat snapshot names: lowercase letters, digits and dashes. */
+const snapshotName = (id, name) => Effect.map(boatName(id, name, 63), (value) => name !== undefined ? value : value.replace(/[^a-z0-9-]/g, "-"));
+const setupHashOf = (props) => Effect.map(sha256Object({
+    from: props.from === undefined ? null : [props.from.name, props.from.setupHash ?? null],
+    run: props.run,
+    env: props.env ?? {},
+    cwd: props.cwd ?? null,
+    type: props.type ?? "default",
+}), (hash) => hash.slice(0, 16));
+const observeSnapshot = (name) => boat.getSavedSnapshot({ name }).pipe(Effect.map((got) => got.snapshot), Effect.catchTag("NotFound", () => Effect.undefined));
+const toAttributes = (snapshot, setupHash) => ({
+    name: snapshot.name,
+    snapshotId: snapshot.snapshotId,
+    type: snapshot.type,
+    sizeBytes: snapshot.sizeBytes,
+    setupHash,
+});
+/** POSIX single quotes: the value verbatim. */
+const quote = (value) => `'${value.replaceAll("'", `'"'"'`)}'`;
+/** Saving takes seconds; poll until Boat reports `ready` or `failed` (about 90s at most). */
+const awaitSaved = (name) => boat.getSavedSnapshot({ name }).pipe(Effect.map((got) => got.snapshot), Effect.repeat({
+    schedule: Schedule.spaced("3 seconds"),
+    until: (snapshot) => snapshot.status !== "saving",
+    times: 30,
+}), Effect.flatMap((snapshot) => snapshot.status === "ready"
+    ? Effect.succeed(snapshot)
+    : new SnapshotFailed({
+        snapshot: name,
+        message: snapshot.status === "failed"
+            ? `Boat could not save snapshot ${name}: ${snapshot.error ?? "unknown error"}`
+            : `Boat snapshot ${name} was still saving after 90 seconds`,
+    })));
+/**
+ * Starts a setup sandbox (from `from`, with none of the account's secrets),
+ * runs the commands, saves it as `name`, and always deletes the sandbox.
+ */
+const takeSnapshot = Effect.fn(function* (id, name, props) {
+    const labels = yield* ownershipLabels(id);
+    return yield* Effect.acquireUseRelease(boat.createSandbox({
+        noEnv: true,
+        ttlSeconds: 1800,
+        ...(props.type === undefined ? {} : { type: props.type }),
+        ...(props.from === undefined ? {} : { from: props.from.name }),
+        labels,
+    }), ({ sandbox }) => Effect.gen(function* () {
+        const exports = Object.entries(props.env ?? {})
+            .map(([key, value]) => `export ${key}=${quote(value)}; `)
+            .join("");
+        for (const command of props.run) {
+            const result = yield* boat.executeSandboxCommand({
+                sandboxId: sandbox.id,
+                command: `${exports}${command}`,
+                timeoutSeconds: 600,
+                ...(props.cwd === undefined ? {} : { cwd: props.cwd }),
+            });
+            const exitCode = "exitCode" in result ? (result.exitCode ?? -1) : -1;
+            const timedOut = "timedOut" in result && result.timedOut === true;
+            if (exitCode !== 0 || timedOut) {
+                return yield* new SnapshotSetupFailed({
+                    message: timedOut
+                        ? `snapshot ${name}: \`${command}\` ran past 10 minutes`
+                        : `snapshot ${name}: \`${command}\` exited with ${exitCode}`,
+                    command,
+                    exitCode,
+                    stderr: "stderr" in result ? result.stderr.slice(-4000) : "",
+                });
+            }
+        }
+        yield* boat.saveSavedSnapshot({ sandboxId: sandbox.id, name });
+        return yield* awaitSaved(name);
+    }), ({ sandbox }) => Effect.ignore(boat.deleteSandbox({ sandboxId: sandbox.id, xAsciiConfirmDelete: sandbox.id })));
+});
+export const SnapshotProvider = () => Provider.effect(Snapshot, Effect.gen(function* () {
+    return {
+        stables: ["name"],
+        diff: Effect.fn(function* ({ id, news, olds, output }) {
+            if (!isResolved(news) || olds === undefined)
+                return undefined;
+            const name = yield* snapshotName(id, news.name ?? output?.name);
+            if (output !== undefined && name !== output.name)
+                return { action: "replace" };
+            if (output !== undefined && (yield* setupHashOf(news)) !== output.setupHash) {
+                return { action: "update" };
+            }
+            return undefined;
+        }),
+        read: Effect.fn(function* ({ id, olds, output }) {
+            const name = output?.name ?? (yield* snapshotName(id, olds?.name));
+            const snapshot = yield* observeSnapshot(name);
+            if (snapshot === undefined)
+                return undefined;
+            const attrs = toAttributes(snapshot, output?.setupHash ?? "");
+            return output !== undefined || isGeneratedName(snapshot.name) ? attrs : Unowned(attrs);
+        }),
+        lookup: Effect.fn(function* ({ name }) {
+            const snapshot = yield* observeSnapshot(name);
+            return snapshot === undefined ? undefined : toAttributes(snapshot, "");
+        }),
+        reconcile: Effect.fn(function* ({ id, news, output, session }) {
+            const name = yield* snapshotName(id, news.name ?? output?.name);
+            const setupHash = yield* setupHashOf(news);
+            // Observe — a ready snapshot of this exact setup is kept.
+            const observed = yield* observeSnapshot(name);
+            if (observed?.status === "ready" && output?.setupHash === setupHash) {
+                return toAttributes(observed, setupHash);
+            }
+            // Ensure — saving under an existing name replaces its disk.
+            yield* session.note(`Building snapshot ${name}...`);
+            return toAttributes(yield* takeSnapshot(id, name, news), setupHash);
+        }),
+        delete: Effect.fn(function* ({ output }) {
+            yield* boat
+                .deleteSavedSnapshot({ name: output.name })
+                .pipe(Effect.catchTag("NotFound", () => Effect.void));
+        }),
+        list: Effect.fn(function* () {
+            const listed = yield* boat.listSavedSnapshots({});
+            return listed.snapshots
+                .filter((snapshot) => isGeneratedName(snapshot.name))
+                .map((snapshot) => toAttributes(snapshot, ""));
+        }),
+    };
+}));
+//# sourceMappingURL=Snapshot.js.map

package/lib/Snapshot.js.map

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

package/lib/Webhook.d.ts

@@ -0,0 +1,56 @@
+import * as boat from "@distilled.cloud/boat-dev/boat";
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import * as Redacted from "effect/Redacted";
+import type { Providers } from "./Providers.ts";
+/** A sandbox lifecycle event Boat delivers. */
+export type WebhookEvent = "sandbox.ready" | "sandbox.hydrated" | "sandbox.error" | "sandbox.archived" | "sandbox.degraded" | "sandbox.recovered";
+/** Every sandbox lifecycle event Boat sends. */
+export declare const ALL_SANDBOX_EVENTS: ReadonlyArray<WebhookEvent>;
+export interface WebhookProps {
+    /** The public HTTPS endpoint (port 443) Boat POSTs events to. Updated in place. */
+    url: string;
+    /** The events to deliver. Updated in place. */
+    events: WebhookEvent[];
+    /**
+     * Display name. If omitted, a unique name is generated from the stack,
+     * stage and logical ID. Renamed in place.
+     */
+    name?: string;
+}
+export interface WebhookAttributes {
+    /** Boat's webhook id (`wh_…`). */
+    webhookId: string;
+    name: string;
+    url: string;
+    events: WebhookEvent[];
+    /**
+     * The secret Boat signs deliveries with. Boat shows it once, at creation;
+     * Alchemy keeps it in state.
+     */
+    secret: Redacted.Redacted<string>;
+}
+export interface Webhook extends Resource<"Boat.Webhook", WebhookProps, WebhookAttributes, never, Providers> {
+}
+/**
+ * A Boat webhook: Boat POSTs sandbox lifecycle events (`sandbox.ready`,
+ * `sandbox.error`, `sandbox.archived`, `sandbox.hydrated`,
+ * `sandbox.degraded`, `sandbox.recovered`) to your endpoint, signed with
+ * `secret`.
+ *
+ * ### Receiving sandbox events
+ * **Example:** Deliver events to a Worker
+ * ```typescript
+ * const receiver = yield* Receiver;
+ * const hook = yield* Boat.Webhook("Events", {
+ *   url: Output.interpolate`${receiver.url}/boat`,
+ *   events: ["sandbox.ready", "sandbox.archived"],
+ * });
+ * ```
+ *
+ * @resource
+ * @product Webhook
+ */
+export declare const Webhook: import("alchemy/Resource").ResourceClass<Webhook>;
+export declare const WebhookProvider: () => import("effect/Layer").Layer<Provider.Provider<Webhook>, never, import("alchemy/Stack").Stack | import("alchemy/Stage").Stage | boat.BoatOpContext>;
+//# sourceMappingURL=Webhook.d.ts.map

package/lib/Webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Webhook.d.ts","sources":["../src/Webhook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,gCAAgC,CAAC;AAEvD,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,+CAA+C;AAC/C,MAAM,MAAM,YAAY,GACpB,eAAe,GACf,kBAAkB,GAClB,eAAe,GACf,kBAAkB,GAClB,kBAAkB,GAClB,mBAAmB,CAAC;AAExB,gDAAgD;AAChD,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC,YAAY,CAO1D,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,mFAAmF;IACnF,GAAG,EAAE,MAAM,CAAC;IACZ,+CAA+C;IAC/C,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB;;;OAGG;IACH,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,OAAQ,SAAQ,QAAQ,CACvC,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,KAAK,EACL,SAAS,CACV;CAAG;AAEJ;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,OAAO,mDAAoC,CAAC;AAyBzD,eAAO,MAAM,eAAe,2JAyDzB,CAAC"}

package/lib/Webhook.js

@@ -0,0 +1,98 @@
+import * as boat from "@distilled.cloud/boat-dev/boat";
+import { Unowned } from "alchemy/AdoptPolicy";
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import * as Effect from "effect/Effect";
+import * as Redacted from "effect/Redacted";
+import { boatName, isGeneratedName } from "./internal/Ownership.js";
+/** Every sandbox lifecycle event Boat sends. */
+export const ALL_SANDBOX_EVENTS = [
+    "sandbox.ready",
+    "sandbox.hydrated",
+    "sandbox.error",
+    "sandbox.archived",
+    "sandbox.degraded",
+    "sandbox.recovered",
+];
+/**
+ * A Boat webhook: Boat POSTs sandbox lifecycle events (`sandbox.ready`,
+ * `sandbox.error`, `sandbox.archived`, `sandbox.hydrated`,
+ * `sandbox.degraded`, `sandbox.recovered`) to your endpoint, signed with
+ * `secret`.
+ *
+ * ### Receiving sandbox events
+ * **Example:** Deliver events to a Worker
+ * ```typescript
+ * const receiver = yield* Receiver;
+ * const hook = yield* Boat.Webhook("Events", {
+ *   url: Output.interpolate`${receiver.url}/boat`,
+ *   events: ["sandbox.ready", "sandbox.archived"],
+ * });
+ * ```
+ *
+ * @resource
+ * @product Webhook
+ */
+export const Webhook = Resource("Boat.Webhook");
+const redact = (value) => Redacted.isRedacted(value) ? value : Redacted.make(value);
+const observeWebhook = (webhookId) => boat.getWebhook({ webhookId }).pipe(Effect.map((got) => got.webhook), Effect.catchTag("NotFound", () => Effect.undefined));
+const toAttributes = (webhook, secret) => ({
+    webhookId: webhook.id,
+    name: webhook.name ?? "",
+    url: webhook.url,
+    events: [...webhook.events],
+    secret,
+});
+const sameEvents = (a, b) => JSON.stringify([...a].sort()) === JSON.stringify([...b].sort());
+export const WebhookProvider = () => Provider.effect(Webhook, Effect.gen(function* () {
+    return {
+        stables: ["webhookId"],
+        read: Effect.fn(function* ({ olds, output }) {
+            // Boat shows the signing secret only at creation, so a webhook is
+            // only usable through state.
+            if (output === undefined)
+                return undefined;
+            const webhook = yield* observeWebhook(output.webhookId);
+            if (webhook === undefined)
+                return undefined;
+            const attrs = toAttributes(webhook, output.secret);
+            return olds !== undefined || isGeneratedName(webhook.name) ? attrs : Unowned(attrs);
+        }),
+        reconcile: Effect.fn(function* ({ id, news, output, session }) {
+            const name = yield* boatName(id, news.name ?? output?.name, 100);
+            // Observe
+            let webhook = output === undefined ? undefined : yield* observeWebhook(output.webhookId);
+            // Ensure
+            if (webhook === undefined || output === undefined) {
+                yield* session.note(`Creating webhook ${name}...`);
+                const created = yield* boat.createWebhook({ name, url: news.url, events: news.events });
+                return toAttributes(created.webhook, redact(created.secret));
+            }
+            // Sync — name, URL and events, against what Boat reports.
+            if (webhook.name !== name ||
+                webhook.url !== news.url ||
+                !sameEvents(webhook.events, news.events)) {
+                const updated = yield* boat.updateWebhook({
+                    webhookId: webhook.id,
+                    name,
+                    url: news.url,
+                    events: news.events,
+                });
+                webhook = updated.webhook;
+            }
+            return toAttributes(webhook, output.secret);
+        }),
+        delete: Effect.fn(function* ({ output }) {
+            yield* boat
+                .deleteWebhook({ webhookId: output.webhookId })
+                .pipe(Effect.catchTag("NotFound", () => Effect.void));
+        }),
+        list: Effect.fn(function* () {
+            const listed = yield* boat.listWebhooks({});
+            return listed.webhooks
+                .filter((webhook) => isGeneratedName(webhook.name))
+                .map((webhook) => toAttributes(webhook, Redacted.make("")));
+        }),
+    };
+}));
+//# sourceMappingURL=Webhook.js.map

package/lib/Webhook.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,19 @@
+export * from "./AiProxy.ts";
+export * from "./ApiKey.ts";
+export * from "./AuthProvider.ts";
+export * from "./ConnectSandbox.ts";
+export * from "./ConnectSandboxHttp.ts";
+export * from "./CreateSandbox.ts";
+export * from "./CreateSandboxHttp.ts";
+export * from "./CredentialProfile.ts";
+export * from "./Credentials.ts";
+export * from "./Environment.ts";
+export * from "./Errors.ts";
+export * from "./Providers.ts";
+export * from "./Sandbox.ts";
+export * from "./SandboxClient.ts";
+export * from "./SandboxEvents.ts";
+export * from "./SandboxEventsLive.ts";
+export * from "./Snapshot.ts";
+export * from "./Webhook.ts";
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC"}

package/lib/index.js

@@ -0,0 +1,19 @@
+export * from "./AiProxy.js";
+export * from "./ApiKey.js";
+export * from "./AuthProvider.js";
+export * from "./ConnectSandbox.js";
+export * from "./ConnectSandboxHttp.js";
+export * from "./CreateSandbox.js";
+export * from "./CreateSandboxHttp.js";
+export * from "./CredentialProfile.js";
+export * from "./Credentials.js";
+export * from "./Environment.js";
+export * from "./Errors.js";
+export * from "./Providers.js";
+export * from "./Sandbox.js";
+export * from "./SandboxClient.js";
+export * from "./SandboxEvents.js";
+export * from "./SandboxEventsLive.js";
+export * from "./Snapshot.js";
+export * from "./Webhook.js";
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC"}

package/lib/internal/Declared.d.ts

@@ -0,0 +1,34 @@
+import type { PropsInput } from "alchemy/Input";
+import * as Output from "alchemy/Output";
+import * as Effect from "effect/Effect";
+import * as Redacted from "effect/Redacted";
+import type { Providers } from "../Providers.ts";
+type Leaf = string | number | boolean | bigint | symbol | null | undefined | Redacted.Redacted<any> | Uint8Array | Date | ((...args: any[]) => any);
+/**
+ * A prop value, or the declaration of a resource that has it: `template: Node`
+ * instead of `template: yield* Node`, at any depth.
+ */
+export type Declared<T> = T extends Leaf ? T : T extends Output.Output<any> ? T : T extends ReadonlyArray<infer U> ? Declared<U>[] | Effect.Effect<T, never, Providers> : {
+    [K in keyof T]: Declared<T[K]>;
+} | Effect.Effect<T, never, Providers>;
+/** Props where any value may be a resource declaration. */
+export type DeclaredProps<P> = {
+    [K in keyof PropsInput<P>]: Declared<PropsInput<P>[K]>;
+};
+/**
+ * A declaration still to be yielded: an Effect that isn't an Output, a
+ * resource, or a Config (which the engine resolves as a prop value).
+ */
+export declare const isDeclaration: (value: unknown) => value is Effect.Effect<unknown, never, Providers>;
+/** Yield every declaration in `value`, at any depth. */
+export declare const resolveDeclarations: (value: unknown) => Effect.Effect<unknown, never, Providers>;
+/**
+ * Let a resource's props hold declarations of other resources, which are
+ * yielded when the resource is: `Boat.Sandbox("Box", { snapshot: Golden })`.
+ * Props without declarations are passed through unchanged.
+ */
+export declare const declarable: <R extends {
+    readonly Props: any;
+}>() => <C extends object>(resource: C) => C & ((id: string, props: DeclaredProps<R["Props"]>) => Effect.Effect<R, never, Providers>);
+export {};
+//# sourceMappingURL=Declared.d.ts.map

package/lib/internal/Declared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Declared.d.ts","sources":["../../src/internal/Declared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,gBAAgB,CAAC;AAGzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,KAAK,IAAI,GACL,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,GACN,MAAM,GACN,IAAI,GACJ,SAAS,GACT,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,GACtB,UAAU,GACV,IAAI,GACJ,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC;AAE9B;;;GAGG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,GACpC,CAAC,GACD,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,GAC1B,CAAC,GACD,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,CAAC,GAC9B,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,GAClD;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;AAEhF,2DAA2D;AAC3D,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,UAAU,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC;AAO1F;;;GAGG;AACH,eAAO,MAAM,aAAa,UAAW,OAAO,KAAG,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,CAItE,CAAC;AAO1B,wDAAwD;AACxD,eAAO,MAAM,mBAAmB,UAAW,OAAO,KAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,CAY7D,CAAC;AAEhC;;;;GAIG;AACH,eAAO,MAAM,UAAU,GACpB,CAAC,SAAS;IAAE,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAA;CAAE,QACjC,CAAC,SAAS,MAAM,YACL,CAAC,KACV,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAM/E,CAAC"}

package/lib/internal/Declared.js

@@ -0,0 +1,38 @@
+import * as Output from "alchemy/Output";
+import { isResource } from "alchemy/Resource";
+import * as Config from "effect/Config";
+import * as Effect from "effect/Effect";
+import * as Redacted from "effect/Redacted";
+const isPlain = (value) => typeof value === "object" &&
+    value !== null &&
+    (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null);
+/**
+ * A declaration still to be yielded: an Effect that isn't an Output, a
+ * resource, or a Config (which the engine resolves as a prop value).
+ */
+export const isDeclaration = (value) => Effect.isEffect(value) &&
+    !Output.isOutput(value) &&
+    !isResource(value) &&
+    !Config.isConfig(value);
+const hasDeclarations = (value) => isDeclaration(value) ||
+    (Array.isArray(value) && value.some(hasDeclarations)) ||
+    (isPlain(value) && !isResource(value) && Object.values(value).some(hasDeclarations));
+/** Yield every declaration in `value`, at any depth. */
+export const resolveDeclarations = (value) => isDeclaration(value)
+    ? value
+    : Array.isArray(value)
+        ? Effect.forEach(value, resolveDeclarations)
+        : isPlain(value) && !isResource(value) && hasDeclarations(value)
+            ? Effect.map(Effect.forEach(Object.entries(value), ([key, entry]) => Effect.map(resolveDeclarations(entry), (resolved) => [key, resolved])), Object.fromEntries)
+            : Effect.succeed(value);
+/**
+ * Let a resource's props hold declarations of other resources, which are
+ * yielded when the resource is: `Boat.Sandbox("Box", { snapshot: Golden })`.
+ * Props without declarations are passed through unchanged.
+ */
+export const declarable = () => (resource) => new Proxy(resource, {
+    apply: (target, self, args) => typeof args[0] === "string" && hasDeclarations(args[1])
+        ? Reflect.apply(target, self, [args[0], resolveDeclarations(args[1])])
+        : Reflect.apply(target, self, args),
+});
+//# sourceMappingURL=Declared.js.map

package/lib/internal/Declared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Declared.js","sources":["../../src/internal/Declared.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AA+B5C,MAAM,OAAO,GAAG,CAAC,KAAc,EAAoC,EAAE,CACnE,OAAO,KAAK,KAAK,QAAQ;IACzB,KAAK,KAAK,IAAI;IACd,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;AAE/F;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAc,EAAqD,EAAE,CACjG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;IACtB,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;IACvB,CAAC,UAAU,CAAC,KAAK,CAAC;IAClB,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAE1B,MAAM,eAAe,GAAG,CAAC,KAAc,EAAW,EAAE,CAClD,aAAa,CAAC,KAAK,CAAC;IACpB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACrD,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC;AAEvF,wDAAwD;AACxD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAc,EAA4C,EAAE,CAC9F,aAAa,CAAC,KAAK,CAAC;IAClB,CAAC,CAAC,KAAK;IACP,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACpB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,mBAAmB,CAAC;QAC5C,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,eAAe,CAAC,KAAK,CAAC;YAC9D,CAAC,CAAC,MAAM,CAAC,GAAG,CACR,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CACrD,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,QAAQ,CAAU,CAAC,CAC/E,EACD,MAAM,CAAC,WAAW,CACnB;YACH,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAEhC;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GACrB,GAAsC,EAAE,CACxC,CACE,QAAW,EACiF,EAAE,CAC9F,IAAI,KAAK,CAAC,QAAiD,EAAE;IAC3D,KAAK,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,IAAe,EAAE,EAAE,CACvC,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrD,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACtE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC;CACxC,CAAU,CAAC"}

package/lib/internal/Org.d.ts

@@ -0,0 +1,22 @@
+import { Credentials } from "@distilled.cloud/boat-dev/Credentials";
+import * as Effect from "effect/Effect";
+/**
+ * The stack's org (`Boat.providers({ org })`, or the profile's), or
+ * `undefined` for none, and for `personal`: both mean what is yours.
+ * `/environments` routes ignore `X-Boat-Org`, so the org the protocol sends
+ * on every other call is passed there as the `org` query.
+ */
+export declare const stackOrg: Effect.Effect<string | undefined, import("@distilled.cloud/boat-dev").ConfigError, Credentials>;
+/** The same organization, however it was spelled (Boat ignores case). */
+export declare const sameOrg: (a: string | undefined, b: string | undefined) => boolean;
+/** The `org` query parameter, when there is an org. */
+export declare const inOrg: (org: string | undefined) => {
+    org: string;
+} | {};
+/** Whether an account (a person or an organization) is the one `org` names. */
+export declare const isOrgAccount: (account: {
+    id: string;
+    kind: "personal" | "org" | (string & {});
+    name: string;
+}, org: string | undefined) => boolean;
+//# sourceMappingURL=Org.d.ts.map

package/lib/internal/Org.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Org.d.ts","sources":["../../src/internal/Org.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACpE,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,iGAInB,CAAC;AAEH,yEAAyE;AACzE,eAAO,MAAM,OAAO,MAAO,MAAM,GAAG,SAAS,KAAK,MAAM,GAAG,SAAS,YACG,CAAC;AAExE,uDAAuD;AACvD,eAAO,MAAM,KAAK,QAAS,MAAM,GAAG,SAAS;;MAAyB,CAAC;AAEvE,+EAA+E;AAC/E,eAAO,MAAM,YAAY,YACd;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,GAAG,KAAK,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,OAC1E,MAAM,GAAG,SAAS,YAKqD,CAAC"}

package/lib/internal/Org.js

@@ -0,0 +1,23 @@
+import { Credentials } from "@distilled.cloud/boat-dev/Credentials";
+import * as Effect from "effect/Effect";
+/**
+ * The stack's org (`Boat.providers({ org })`, or the profile's), or
+ * `undefined` for none, and for `personal`: both mean what is yours.
+ * `/environments` routes ignore `X-Boat-Org`, so the org the protocol sends
+ * on every other call is passed there as the `org` query.
+ */
+export const stackOrg = Effect.gen(function* () {
+    const { org } = yield* yield* Credentials;
+    const named = org?.trim();
+    return named && named.toLowerCase() !== "personal" ? named : undefined;
+});
+/** The same organization, however it was spelled (Boat ignores case). */
+export const sameOrg = (a, b) => (a?.toLowerCase() ?? "personal") === (b?.toLowerCase() ?? "personal");
+/** The `org` query parameter, when there is an org. */
+export const inOrg = (org) => (org ? { org } : {});
+/** Whether an account (a person or an organization) is the one `org` names. */
+export const isOrgAccount = (account, org) => org === undefined
+    ? account.kind === "personal"
+    : account.kind === "org" &&
+        (account.id === org || account.name.toLowerCase() === org.toLowerCase());
+//# sourceMappingURL=Org.js.map

package/lib/internal/Org.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Org.js","sources":["../../src/internal/Org.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACpE,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAC1C,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC;IAC1C,MAAM,KAAK,GAAG,GAAG,EAAE,IAAI,EAAE,CAAC;IAC1B,OAAO,KAAK,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACzE,CAAC,CAAC,CAAC;AAEH,yEAAyE;AACzE,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAqB,EAAE,CAAqB,EAAE,EAAE,CACtE,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,UAAU,CAAC,CAAC;AAExE,uDAAuD;AACvD,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,GAAuB,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAEvE,+EAA+E;AAC/E,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,OAA+E,EAC/E,GAAuB,EACvB,EAAE,CACF,GAAG,KAAK,SAAS;IACf,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,UAAU;IAC7B,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,KAAK;QACtB,CAAC,OAAO,CAAC,EAAE,KAAK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC"}

package/lib/internal/Ownership.d.ts

@@ -0,0 +1,29 @@
+import * as Effect from "effect/Effect";
+/** Labels as Boat returns them. */
+export type Labels = Readonly<Record<string, string | undefined>> | null | undefined;
+/** The prefix Alchemy's ownership labels share. */
+export declare const ALCHEMY_LABEL_PREFIX = "alchemy.";
+/** `alchemy::stack` → `alchemy.stack`. */
+export declare const toLabelKey: (key: string) => string;
+/** This resource's ownership labels: `alchemy.stack`, `alchemy.stage`, `alchemy.id`. */
+export declare const ownershipLabels: (id: string) => Effect.Effect<Record<string, string>, never, import("alchemy/Stack").Stack | import("alchemy/Stage").Stage>;
+/** Whether labels carry this resource's ownership labels. */
+export declare const hasOwnershipLabels: (id: string, labels: Labels) => Effect.Effect<boolean, never, import("alchemy/Stack").Stack | import("alchemy/Stage").Stage>;
+/** Whether labels were set by any Alchemy stack or binding (for nuke). */
+export declare const hasAnyAlchemyLabel: (labels: Labels) => boolean;
+/** Labels without Alchemy's own. */
+export declare const userLabels: (labels: Labels) => Record<string, string>;
+/** `key=value` filters for `listSandboxes`. */
+export declare const labelFilter: (labels: Readonly<Record<string, string>>) => string[];
+/**
+ * A Boat name: the user's, or one generated from the stack, stage and
+ * logical id. Lowercase letters, digits and dashes fit every Boat name rule
+ * (snapshot names allow nothing else).
+ */
+export declare const boatName: (id: string, name: string | undefined, maxLength?: number) => Effect.Effect<string, never, import("alchemy/ResourceContext").ResourceContext | import("alchemy/Stack").Stack | import("alchemy/Stage").Stage>;
+/**
+ * Whether a name looks generated by `createPhysicalName` (lowercase, ending
+ * in a base32 instance suffix). `list` reports only these, for nuke.
+ */
+export declare const isGeneratedName: (name: string | null | undefined) => boolean;
+//# sourceMappingURL=Ownership.d.ts.map

package/lib/internal/Ownership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Ownership.d.ts","sources":["../../src/internal/Ownership.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,mCAAmC;AACnC,MAAM,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;AAErF,mDAAmD;AACnD,eAAO,MAAM,oBAAoB,aAAa,CAAC;AAE/C,0CAA0C;AAC1C,eAAO,MAAM,UAAU,QAAS,MAAM,WAG7B,CAAC;AAEV,wFAAwF;AACxF,eAAO,MAAM,eAAe,6HAK1B,CAAC;AAEH,6DAA6D;AAC7D,eAAO,MAAM,kBAAkB,8HAG7B,CAAC;AAEH,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB,WAAY,MAAM,YACoC,CAAC;AAEtF,oCAAoC;AACpC,eAAO,MAAM,UAAU,WAAY,MAAM,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAM9D,CAAC;AAEJ,+CAA+C;AAC/C,eAAO,MAAM,WAAW,WAAY,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,aACH,CAAC;AAElE;;;;GAIG;AACH,eAAO,MAAM,QAAQ,OAAQ,MAAM,QAAQ,MAAM,GAAG,SAAS,wKAGe,CAAC;AAE7E;;;GAGG;AACH,eAAO,MAAM,eAAe,SAAU,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,OACa,CAAC"}