alchemy 2.0.0-beta.84 → 2.0.0-beta.85

package/lib/Alchemist/Entrypoint.js

@@ -1,7 +1,19 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { pathToFileURL } from "node:url";
+import * as Context from "effect/Context";
 import * as Data from "effect/Data";
 import * as Effect from "effect/Effect";
 import * as FileSystem from "effect/FileSystem";
 import * as Path from "effect/Path";
+import * as Predicate from "effect/Predicate";
+import { emit } from "../Events.js";
 import { UserFacingError } from "../UserFacingError.js";
 export class StackEntrypointError extends Data.TaggedError("StackEntrypointError") {
     [UserFacingError] = true;
@@ -9,9 +21,8 @@ export class StackEntrypointError extends Data.TaggedError("StackEntrypointError
 export const DEFAULT_ENTRYPOINT = "alchemy.run.ts";
 /**
  * The absolute path of the stack entrypoint, or the user-facing error for
- * a missing one. Kept apart from `Session.ts` so the `alchemy dev`
- * supervisor can check the entry before it starts an exec child, without
- * loading the engine that module carries.
+ * a missing one. Kept free of the engine so the `alchemy dev` supervisor can
+ * check the entry before it starts an exec child.
  */
 export const resolveStackEntrypoint = Effect.fn(function* (main) {
     const fs = yield* FileSystem.FileSystem;
@@ -24,4 +35,24 @@ export const resolveStackEntrypoint = Effect.fn(function* (main) {
     }
     return absolutePath;
 });
+export const StackModuleLoader = Context.Reference("Alchemy/Alchemist/StackModuleLoader", { defaultValue: () => ({ import: (url) => import(__rewriteRelativeImportExtension(url)) }) });
+/**
+ * Import a stack entrypoint and return its default export, the stack value
+ * every stack operation takes.
+ */
+export const importStack = Effect.fn("Alchemist.importStack")(function* (main) {
+    yield* emit({ type: "plan.phase", phase: "importing-module" });
+    const absolutePath = yield* resolveStackEntrypoint(main);
+    const loader = yield* StackModuleLoader;
+    const module = yield* Effect.promise(() => loader.import(pathToFileURL(absolutePath).href));
+    if (!Effect.isEffect(module.default) ||
+        !Predicate.hasProperty(module.default, "stackName") ||
+        typeof module.default.stackName !== "string") {
+        return yield* new StackEntrypointError({
+            message: `Stack entrypoint '${main}' must export a default stack definition (export default Alchemy.Stack({...})).`,
+        });
+    }
+    // oxlint-disable-next-line effecttsgo/unsafe-effect-type-assertion -- default export shape validated at runtime above
+    return module.default;
+});
 //# sourceMappingURL=Entrypoint.js.map

package/lib/Alchemist/Entrypoint.js.map

@@ -1 +1 @@
-{"version":3,"file":"Entrypoint.js","sourceRoot":"","sources":["../../src/Alchemist/Entrypoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,OAAO,oBAAqB,SAAQ,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAE/E;IACS,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAY;IACrE,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IACxC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAC9B,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC,CAAC,IAAI,oBAAoB,CAAC;YACrC,OAAO,EAAE,qBAAqB,IAAI,wBAAwB,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,sEAAsE;SAC3J,CAAC,CAAC;IACL,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"Entrypoint.js","sourceRoot":"","sources":["../../src/Alchemist/Entrypoint.ts"],"names":[],"mappings":";;;;;;;;AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,SAAS,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEpC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,OAAO,oBAAqB,SAAQ,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAE/E;IACS,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAY;IACrE,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IACxC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAC9B,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC,CAAC,IAAI,oBAAoB,CAAC;YACrC,OAAO,EAAE,qBAAqB,IAAI,wBAAwB,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,sEAAsE;SAC3J,CAAC,CAAC;IACL,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC,CAAC,CAAC;AAMH,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC,SAAS,CAChD,qCAAqC,EACrC,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,kCAAC,GAAG,EAAC,EAAE,CAAC,EAAE,CAC3D,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,EAAE,CAAC,uBAAuB,CAAC,CAAC,QAAQ,CAAC,EAAE,IAAY;IACnF,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC/D,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,iBAAiB,CAAC;IACxC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5F,IACE,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC;QAChC,CAAC,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC;QACnD,OAAO,MAAM,CAAC,OAAO,CAAC,SAAS,KAAK,QAAQ,EAC5C,CAAC;QACD,OAAO,KAAK,CAAC,CAAC,IAAI,oBAAoB,CAAC;YACrC,OAAO,EAAE,qBAAqB,IAAI,iFAAiF;SACpH,CAAC,CAAC;IACL,CAAC;IACD,sHAAsH;IACtH,OAAO,MAAM,CAAC,OAA4C,CAAC;AAC7D,CAAC,CAAC,CAAC"}

package/lib/Alchemist/Errors.d.ts

@@ -8,7 +8,7 @@ export interface Diagnostic {
 declare const AlchemistInvalidInput_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
     readonly _tag: "AlchemistInvalidInput";
 } & Readonly<A>;
-/** The caller sent something the route cannot act on. */
+/** The caller sent something the operation cannot act on. */
 export declare class AlchemistInvalidInput extends AlchemistInvalidInput_base<{
     readonly message: string;
     readonly field?: string;

package/lib/Alchemist/Errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Errors.d.ts","sourceRoot":"","sources":["../../src/Alchemist/Errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,wDAAwD;AACxD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;;;;AAOD,yDAAyD;AACzD,qBAAa,qBAAsB,SAAQ,2BAA0C;IACnF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;IACA,QAAQ,CAAC,CAAC,eAAe,CAAC,QAAQ;CACnC;;;;AAED,2DAA2D;AAC3D,qBAAa,iBAAkB,SAAQ,uBAAsC;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB,CAAC;IACA,QAAQ,CAAC,CAAC,eAAe,CAAC,QAAQ;IAClC,yEAAyE;IACzE,IAAa,OAAO,IAAI,MAAM,CAE7B;CACF"}
+{"version":3,"file":"Errors.d.ts","sourceRoot":"","sources":["../../src/Alchemist/Errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,wDAAwD;AACxD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;;;;AAOD,6DAA6D;AAC7D,qBAAa,qBAAsB,SAAQ,2BAA0C;IACnF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;IACA,QAAQ,CAAC,CAAC,eAAe,CAAC,QAAQ;CACnC;;;;AAED,2DAA2D;AAC3D,qBAAa,iBAAkB,SAAQ,uBAAsC;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB,CAAC;IACA,QAAQ,CAAC,CAAC,eAAe,CAAC,QAAQ;IAClC,yEAAyE;IACzE,IAAa,OAAO,IAAI,MAAM,CAE7B;CACF"}

package/lib/Alchemist/Errors.js

@@ -4,7 +4,7 @@ import { UserFacingError } from "../UserFacingError.js";
 // clouds we talk to — distilled's core ships `NotFound`, Route53 ships
 // `InvalidInput` — and these errors travel in unions with cloud errors,
 // where `catchTag` discriminates by tag alone.
-/** The caller sent something the route cannot act on. */
+/** The caller sent something the operation cannot act on. */
 export class AlchemistInvalidInput extends Data.TaggedError("AlchemistInvalidInput") {
     [UserFacingError] = true;
 }

package/lib/Alchemist/Errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"Errors.js","sourceRoot":"","sources":["../../src/Alchemist/Errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AASxD,wEAAwE;AACxE,uEAAuE;AACvE,wEAAwE;AACxE,+CAA+C;AAE/C,yDAAyD;AACzD,MAAM,OAAO,qBAAsB,SAAQ,IAAI,CAAC,WAAW,CAAC,uBAAuB,CAGjF;IACS,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC;CACnC;AAED,2DAA2D;AAC3D,MAAM,OAAO,iBAAkB,SAAQ,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAGzE;IACS,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC;IAClC,yEAAyE;IACzE,IAAa,OAAO;QAClB,OAAO,MAAM,IAAI,CAAC,IAAI,WAAW,IAAI,CAAC,EAAE,IAAI,CAAC;IAC/C,CAAC;CACF"}
+{"version":3,"file":"Errors.js","sourceRoot":"","sources":["../../src/Alchemist/Errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AASxD,wEAAwE;AACxE,uEAAuE;AACvE,wEAAwE;AACxE,+CAA+C;AAE/C,6DAA6D;AAC7D,MAAM,OAAO,qBAAsB,SAAQ,IAAI,CAAC,WAAW,CAAC,uBAAuB,CAGjF;IACS,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC;CACnC;AAED,2DAA2D;AAC3D,MAAM,OAAO,iBAAkB,SAAQ,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAGzE;IACS,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC;IAClC,yEAAyE;IACzE,IAAa,OAAO;QAClB,OAAO,MAAM,IAAI,CAAC,IAAI,WAAW,IAAI,CAAC,EAAE,IAAI,CAAC;IAC/C,CAAC;CACF"}

package/lib/Alchemist/Logs.d.ts

@@ -0,0 +1,46 @@
+import * as Effect from "effect/Effect";
+import * as Stream from "effect/Stream";
+import type { ConfiguredStack } from "../Stack.ts";
+import * as State from "../State/index.ts";
+import { AlchemistInvalidInput } from "./Errors.ts";
+import { type BuildOptions } from "./Operations.ts";
+export interface ResourceIdentity {
+    readonly fqn: string;
+    readonly logicalId: string;
+    readonly resourceType: string;
+}
+export interface LogResource extends ResourceIdentity {
+    readonly supportsQuery: boolean;
+    readonly supportsTail: boolean;
+}
+export interface LogEntry {
+    readonly resource: ResourceIdentity;
+    readonly timestamp: Date;
+    readonly message: string;
+}
+export interface LogOptions extends BuildOptions {
+    readonly stack: ConfiguredStack<unknown, unknown>;
+    /** Logical IDs to include. Empty or omitted means every resource. */
+    readonly resources?: ReadonlyArray<string>;
+}
+export interface QueryOptions extends LogOptions {
+    readonly limit?: number;
+    readonly since?: Date;
+}
+/** Every deployed resource, with the log capabilities its provider offers. */
+export declare const resources: (options: BuildOptions & {
+    readonly stack: ConfiguredStack<unknown, unknown>;
+}) => Effect.Effect<LogResource[], AlchemistInvalidInput | import("effect/Config").ConfigError | import("effect/PlatformError").PlatformError | State.StateStoreError, import("../AlchemyContext.ts").AlchemyContext | import("effect/FileSystem").FileSystem>;
+/** Query past log entries across the selected resources, oldest first. */
+export declare const entries: (input: QueryOptions) => Effect.Effect<{
+    resource: {
+        fqn: string;
+        logicalId: string;
+        resourceType: string;
+    };
+    timestamp: Date;
+    message: string;
+}[], any, import("../AlchemyContext.ts").AlchemyContext | import("effect/FileSystem").FileSystem>;
+/** Live-stream log entries from every selected resource that supports it. */
+export declare const tail: (input: LogOptions) => Stream.Stream<LogEntry, any, import("../AlchemyContext.ts").AlchemyContext | import("effect/FileSystem").FileSystem>;
+//# sourceMappingURL=Logs.d.ts.map

package/lib/Alchemist/Logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logs.d.ts","sourceRoot":"","sources":["../../src/Alchemist/Logs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,KAAK,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEhE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,WAAY,SAAQ,gBAAgB;IACnD,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,UAAW,SAAQ,YAAY;IAC9C,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClD,qEAAqE;IACrE,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC;CACvB;AA+DD,8EAA8E;AAC9E,eAAO,MAAM,SAAS;oBACsB,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC;8PAQ5D,CAAC;AAElB,0EAA0E;AAC1E,eAAO,MAAM,OAAO;;;;;;;;iGA2BH,CAAC;AAElB,6EAA6E;AAC7E,eAAO,MAAM,IAAI,UAAW,UAAU,yHAqBnC,CAAC"}

package/lib/Alchemist/{routes/logs.js → Logs.js}

@@ -1,27 +1,22 @@
-import * as Context from "effect/Context";
 import * as Effect from "effect/Effect";
-import * as Layer from "effect/Layer";
 import * as Stream from "effect/Stream";
-import { findProviderByType } from "../../Provider.js";
-import { stampedMode } from "../../ProviderMode.js";
-import * as State from "../../State/index.js";
-import { AlchemistInvalidInput } from "../Errors.js";
-import { open } from "../Session.js";
+import { findProviderByType } from "../Provider.js";
+import { stampedMode } from "../ProviderMode.js";
+import * as State from "../State/index.js";
+import { AlchemistInvalidInput } from "./Errors.js";
+import { buildStack } from "./Operations.js";
 /**
- * Open the stack and pair every deployed resource with the provider that
+ * Build the stack and pair every deployed resource with the provider that
  * can speak for it. `entries` and `tail` differ only in which provider hook
- * they then call, so the selection lives here once.
+ * they then call, so the selection lives here once. The build lives in the
+ * ambient `Scope`; each public function closes its own.
  */
 const select = Effect.fn(function* (input) {
-    const session = yield* open(input.target);
-    // The local store sits UNDER the session context, so the stack's own
-    // store wins where it configures one: a project may only wire a remote
-    // store at deploy time, and `alchemy logs` still has to resolve what was
-    // deployed.
-    const context = Context.merge(yield* Layer.build(State.localState()), session.context);
+    const built = yield* buildStack(input.stack, input);
+    const context = built.context;
     const selected = new Set(input.resources ?? []);
     const available = [
-        ...new Set(Object.values(session.stack.resources).map((resource) => resource.LogicalId)),
+        ...new Set(Object.values(built.stack.resources).map((resource) => resource.LogicalId)),
     ].sort();
     const unknown = [...selected].find((name) => !available.includes(name));
     if (unknown !== undefined) {
@@ -31,14 +26,14 @@ const select = Effect.fn(function* (input) {
         });
     }
     const rows = yield* Effect.provide(Effect.gen(function* () {
-        const state = yield* yield* State.State;
-        return yield* Effect.forEach(Object.entries(session.stack.resources), ([fqn, resource]) => Effect.gen(function* () {
+        const state = yield* Effect.flatten(State.State);
+        return yield* Effect.forEach(Object.entries(built.stack.resources), ([fqn, resource]) => Effect.gen(function* () {
             if (selected.size > 0 && !selected.has(resource.LogicalId)) {
                 return [];
             }
             const stored = yield* state.get({
-                stack: session.stack.name,
-                stage: session.stack.stage,
+                stack: built.stack.name,
+                stage: built.stack.stage,
                 fqn,
             });
             if (!State.isResourceState(stored) || stored.attr === undefined) {
@@ -66,16 +61,16 @@ const select = Effect.fn(function* (input) {
     return { context, rows };
 });
 /** Every deployed resource, with the log capabilities its provider offers. */
-export const resources = Effect.fn("Alchemist.logs.resources")(function* (target) {
-    const { rows } = yield* select({ target });
+export const resources = Effect.fn("Alchemist.Logs.resources")(function* (options) {
+    const { rows } = yield* select(options);
     return rows.map(({ resource, provider }) => ({
         ...resource,
         supportsQuery: provider.logs !== undefined,
         supportsTail: provider.tail !== undefined,
     }));
-});
+}, Effect.scoped);
 /** Query past log entries across the selected resources, oldest first. */
-export const entries = Effect.fn("Alchemist.logs.entries")(function* (input) {
+export const entries = Effect.fn("Alchemist.Logs.entries")(function* (input) {
     const { context, rows } = yield* select(input);
     const entries = yield* Effect.provide(Effect.forEach(rows, ({ resource, provider, request }) => provider.logs === undefined
         ? Effect.succeed([])
@@ -93,7 +88,7 @@ export const entries = Effect.fn("Alchemist.logs.entries")(function* (input) {
             message: line.message,
         }))))), context);
     return entries.flat().sort((a, b) => a.timestamp.getTime() - b.timestamp.getTime());
-});
+}, Effect.scoped);
 /** Live-stream log entries from every selected resource that supports it. */
 export const tail = (input) => Stream.unwrap(Effect.gen(function* () {
     const { context, rows } = yield* select(input);
@@ -107,4 +102,4 @@ export const tail = (input) => Stream.unwrap(Effect.gen(function* () {
             }))),
         ]), { concurrency: "unbounded" });
 }));
-//# sourceMappingURL=logs.js.map
+//# sourceMappingURL=Logs.js.map

package/lib/Alchemist/Logs.js.map

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

package/lib/Alchemist/Nuke.d.ts

@@ -0,0 +1,69 @@
+import type * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Nuke from "../Nuke.ts";
+import type { ProviderMode } from "../ProviderMode.ts";
+import type { ConfiguredStack } from "../Stack.ts";
+import { type ConfigOptions } from "./Operations.ts";
+export interface ScanOptions extends ConfigOptions {
+    /** The stack whose providers are scanned; nothing reads its state. */
+    readonly stack: ConfiguredStack<unknown, unknown>;
+    /** Scan the emulators `alchemy dev` runs instead of the real cloud. */
+    readonly dev?: boolean;
+    /** Provider-id globs to include. Omitted means every provider. */
+    readonly include?: ReadonlyArray<string>;
+    /** Provider-id globs to exclude. Applied after `include`. */
+    readonly exclude?: ReadonlyArray<string>;
+    /** Providers scanned in parallel. @default 16 */
+    readonly concurrency?: number | "unbounded";
+    /** Timeout for each provider's `list`. @default 120 */
+    readonly providerTimeoutSeconds?: number;
+}
+/** One discovered cloud object, bound to the provider that can delete it. */
+export type Resource = Nuke.Target;
+/** Everything a stack's providers can see; only {@link execute} deletes it. */
+export interface NukeScan {
+    /** `local` when the scan ran with `dev: true`, otherwise `live`. */
+    readonly mode: ProviderMode;
+    readonly resources: ReadonlyArray<Resource>;
+    /** Providers whose `list` failed; they contribute no resources. */
+    readonly failures: ReadonlyArray<Nuke.ProviderFailure>;
+    /**
+     * The built provider context; lives in the caller's `Scope`.
+     * @internal {@link execute} deletes under it.
+     */
+    readonly context: Context.Context<never>;
+}
+/**
+ * List everything the stack's registered providers can see in the account.
+ * The stack is imported only for its providers: nothing here reads state or
+ * is scoped to a stage.
+ */
+export declare const scan: (options: ScanOptions) => Effect.Effect<{
+    mode: ProviderMode;
+    resources: readonly Nuke.Target[];
+    failures: readonly Nuke.ProviderFailure[];
+    context: Context.Context<import("../AdoptPolicy.ts").AdoptPolicy | import("../AlchemyContext.ts").AlchemyContext | import("../Artifacts.ts").ArtifactStore | import("../index.ts").AuthProviders | import("../Stack.ts").Stack | import("../Stage.ts").Stage | import("../State/State.ts").State>;
+}, import("effect/Config").ConfigError | import("effect/PlatformError").PlatformError, import("../AlchemyContext.ts").AlchemyContext | import("effect/process/ChildProcessSpawner").ChildProcessSpawner | import("../Auth/Credentials.ts").CredentialsStore | import("effect/crypto/Digest").Digest | import("effect/FileSystem").FileSystem | import("effect/http/HttpClient").HttpClient | import("../Interaction.ts").Interaction | import("effect/Path").Path | import("../Auth/Profile.ts").ProfileStore | import("effect/Scope").Scope | import("effect/crypto/SecureRandom").SecureRandom>;
+export interface ExecuteOptions {
+    /** The scan whose resources are deleted. */
+    readonly scan: NukeScan;
+    /** The subset of `scan.resources` to delete. @default every planned resource */
+    readonly resources?: ReadonlyArray<Resource>;
+    /**
+     * `coordinated` deletes in passes until one makes no progress;
+     * `independent` retries each resource on its own.
+     * @default { type: "coordinated" }
+     */
+    readonly strategy?: Nuke.Strategy;
+    /** Providers deleted in parallel. @default 16 */
+    readonly concurrency?: number | "unbounded";
+    /** Timeout for each `delete`. @default 120 */
+    readonly providerTimeoutSeconds?: number;
+}
+export type Result = Nuke.Result;
+/**
+ * Permanently delete scanned resources. Progress is emitted through
+ * events: `apply.resource.status` and `nuke.*` events.
+ */
+export declare const execute: (options: ExecuteOptions) => Effect.Effect<Nuke.Result, never, never>;
+//# sourceMappingURL=Nuke.d.ts.map

package/lib/Alchemist/Nuke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Nuke.d.ts","sourceRoot":"","sources":["../../src/Alchemist/Nuke.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,YAAY,CAAC;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErE,MAAM,WAAW,WAAY,SAAQ,aAAa;IAChD,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClD,uEAAuE;IACvE,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,kEAAkE;IAClE,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACzC,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACzC,iDAAiD;IACjD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC5C,uDAAuD;IACvD,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;CAC1C;AAED,6EAA6E;AAC7E,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC;AAEnC,+EAA+E;AAC/E,MAAM,WAAW,QAAQ;IACvB,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC5C,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACvD;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;CAC1C;AAED;;;;GAIG;AACH,eAAO,MAAM,IAAI;;;;;ikBAYf,CAAC;AAEH,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,gFAAgF;IAChF,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC;IAClC,iDAAiD;IACjD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC5C,8CAA8C;IAC9C,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;CAC1C;AAED,MAAM,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;AAEjC;;;GAGG;AACH,eAAO,MAAM,OAAO,uEAQlB,CAAC"}

package/lib/Alchemist/Nuke.js

@@ -0,0 +1,35 @@
+import * as Effect from "effect/Effect";
+import * as Nuke from "../Nuke.js";
+import { buildProviders } from "./Operations.js";
+/**
+ * List everything the stack's registered providers can see in the account.
+ * The stack is imported only for its providers: nothing here reads state or
+ * is scoped to a stage.
+ */
+export const scan = Effect.fn("Alchemist.Nuke.scan")(function* (options) {
+    const mode = options.dev ? "local" : "live";
+    const context = yield* buildProviders(options.stack, options);
+    const { resources, failures } = yield* Nuke.list({
+        context,
+        mode,
+        include: options.include,
+        exclude: options.exclude,
+        concurrency: options.concurrency,
+        timeoutSeconds: options.providerTimeoutSeconds,
+    });
+    return { mode, resources, failures, context };
+});
+/**
+ * Permanently delete scanned resources. Progress is emitted through
+ * events: `apply.resource.status` and `nuke.*` events.
+ */
+export const execute = Effect.fn("Alchemist.Nuke.execute")(function* (options) {
+    return yield* Nuke.destroy({
+        targets: options.resources ?? options.scan.resources,
+        context: options.scan.context,
+        strategy: options.strategy ?? { type: "coordinated" },
+        concurrency: options.concurrency,
+        timeoutSeconds: options.providerTimeoutSeconds,
+    });
+});
+//# sourceMappingURL=Nuke.js.map

package/lib/Alchemist/Nuke.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Nuke.js","sourceRoot":"","sources":["../../src/Alchemist/Nuke.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,YAAY,CAAC;AAGnC,OAAO,EAAE,cAAc,EAAsB,MAAM,iBAAiB,CAAC;AAkCrE;;;;GAIG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,qBAAqB,CAAC,CAAC,QAAQ,CAAC,EAAE,OAAoB;IAClF,MAAM,IAAI,GAAiB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IAC1D,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC9D,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC/C,OAAO;QACP,IAAI;QACJ,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,cAAc,EAAE,OAAO,CAAC,sBAAsB;KAC/C,CAAC,CAAC;IACH,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAqB,CAAC;AACnE,CAAC,CAAC,CAAC;AAqBH;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC,wBAAwB,CAAC,CAAC,QAAQ,CAAC,EAAE,OAAuB;IAC3F,OAAO,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;QACzB,OAAO,EAAE,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,SAAS;QACpD,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO;QAC7B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE;QACrD,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,cAAc,EAAE,OAAO,CAAC,sBAAsB;KAC/C,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/lib/Alchemist/Operations.d.ts

@@ -0,0 +1,168 @@
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Tracer from "effect/Tracer";
+import { AdoptPolicy } from "../AdoptPolicy.ts";
+import { AlchemyContext } from "../AlchemyContext.ts";
+import * as Apply from "../Apply.ts";
+import { ArtifactStore } from "../Artifacts.ts";
+import { type PlannedAction, type PlannedResource } from "../Events.ts";
+import * as Plan from "../Plan.ts";
+import type { ResourceSelection, SelectionOutput } from "../ResourceSelection.ts";
+import * as Stack from "../Stack.ts";
+import { Stage } from "../Stage.ts";
+import type { State } from "../State/State.ts";
+/** Which credentials and config a stack build sees. */
+export interface ConfigOptions {
+    /** `.env` file layered under the process environment. */
+    readonly envFile?: string;
+    /** Profile whose credentials the run uses. Falls back to the active profile. */
+    readonly profile?: string;
+}
+export interface BuildOptions extends ConfigOptions {
+    readonly stage: string;
+    /** Run local (emulated) providers instead of the real cloud. */
+    readonly dev?: boolean;
+    /** Adopt pre-existing cloud resources instead of failing on conflict. */
+    readonly adopt?: boolean;
+    /** Upgrade an out-of-date state store without prompting. */
+    readonly updateStateStore?: boolean;
+}
+/** Config services shared by every stack build. */
+export declare const configServices: (options: ConfigOptions) => Effect.Effect<Layer.Layer<never, never, never>, import("effect/PlatformError").PlatformError, import("effect/FileSystem").FileSystem>;
+/**
+ * Build a stack's providers and state store and run its program.
+ *
+ * @internal used by {@link plan} and `Logs`.
+ */
+export declare const buildStack: <Output, Req>(stack: Stack.ConfiguredStack<Output, Req>, options: BuildOptions) => Effect.Effect<{
+    stack: Stack.CompiledStack<Output, any>;
+    /** The stack's own providers and state store over the build's services. */
+    context: Context.Context<any>;
+}, import("effect/Config").ConfigError | import("effect/PlatformError").PlatformError, AlchemyContext | import("effect/FileSystem").FileSystem | import("effect/Scope").Scope>;
+/**
+ * Build a stack's providers and state store without running its program:
+ * all that destroy, drift, and state access need, and safe when the
+ * program itself no longer runs.
+ *
+ * @internal used by {@link plan}, `Drift.scan`, and `State.store`.
+ */
+export declare const buildWithoutProgram: <Req>(stack: Stack.ConfiguredStack<unknown, Req>, options: BuildOptions) => Effect.Effect<{
+    stack: {
+        name: string;
+        stage: string;
+        resources: {
+            [logicalId: string]: import("../Resource.ts").ResourceLike;
+        };
+        bindings: {
+            [logicalId: string]: import("../Resource.ts").ResourceBinding[];
+        };
+        actions: {
+            [logicalId: string]: import("../Action.ts").ActionLike;
+        };
+        output: undefined;
+    };
+    context: Context.Context<AdoptPolicy | AlchemyContext | ArtifactStore | import("../index.ts").AuthProviders | Stack.Stack | Stage | State | Exclude<Extract<Req, Stack.ProviderServices>, Tracer.ParentSpan>>;
+}, import("effect/Config").ConfigError | import("effect/PlatformError").PlatformError, AlchemyContext | import("effect/process/ChildProcessSpawner").ChildProcessSpawner | import("../Auth/Credentials.ts").CredentialsStore | import("effect/crypto/Digest").Digest | import("effect/FileSystem").FileSystem | import("effect/http/HttpClient").HttpClient | import("../Interaction.ts").Interaction | import("effect/Path").Path | import("../Auth/Profile.ts").ProfileStore | import("effect/Scope").Scope | import("effect/crypto/SecureRandom").SecureRandom>;
+export interface PlanSummary {
+    readonly create: number;
+    readonly update: number;
+    readonly adopted: number;
+    readonly replace: number;
+    readonly delete: number;
+    readonly orphaned: number;
+    /** Actions that will run. */
+    readonly run: number;
+    readonly noop: number;
+}
+/** Whether a plan or drift scan proposes any cloud mutations (i.e. approval-worthy work). */
+export declare const hasChanges: ({ summary }: {
+    readonly summary: PlanSummary;
+}) => boolean;
+export declare const summarize: (plan: Plan.Plan) => PlanSummary;
+/** The services a stack plan is applied under. */
+type StackContext = Context.Context<State | Stack.Stack | Stage>;
+/**
+ * A deploy or destroy plan: what will change, and the built stack it was
+ * planned against so {@link apply} runs without rebuilding.
+ */
+export interface StackPlan<Output = unknown> {
+    readonly stack: {
+        readonly name: string;
+        readonly stage: string;
+    };
+    readonly summary: PlanSummary;
+    /** Serializable resource rows (including orphan deletions). */
+    readonly resources: ReadonlyArray<PlannedResource>;
+    /** Serializable stack-action rows. */
+    readonly actions: ReadonlyArray<PlannedAction>;
+    /**
+     * The engine plan `apply` executes, for renderers.
+     * @internal its shape may change.
+     */
+    readonly native: Plan.Plan<Output>;
+    /**
+     * The stack services the plan was computed under; they live in the caller's `Scope`.
+     * @internal `apply` runs in them.
+     */
+    readonly context: StackContext;
+}
+/** Describe an engine plan computed on a built stack. */
+export declare const describeStackPlan: <Output>(built: {
+    readonly stack: {
+        readonly name: string;
+        readonly stage: string;
+    };
+    readonly context: StackContext;
+}, native: Plan.Plan<Output>) => Effect.Effect<{
+    resources: ReadonlyArray<PlannedResource>;
+    actions: ReadonlyArray<PlannedAction>;
+    stack: {
+        name: string;
+        stage: string;
+    };
+    summary: PlanSummary;
+    native: Plan.Plan<Output>;
+    context: StackContext;
+}, never, never>;
+/**
+ * Run the stack's program and plan what to create, update, replace, and
+ * delete so the stage matches it.
+ */
+export interface DeployPlanOptions extends BuildOptions, ResourceSelection {
+    readonly operation: "deploy";
+    /** Re-run every Action regardless of input drift. */
+    readonly force?: boolean;
+}
+/**
+ * Plan deleting everything the stage owns. The program never runs, so this
+ * works even when it no longer does. Always the whole stage.
+ */
+export interface DestroyPlanOptions extends BuildOptions {
+    readonly operation: "destroy";
+}
+export type PlanOptions = DeployPlanOptions | DestroyPlanOptions;
+/** What applying a plan made with `O` returns. */
+export type PlanOutput<Output, O extends PlanOptions> = O extends {
+    readonly operation: "destroy";
+} ? undefined : SelectionOutput<Output, O>;
+/**
+ * Plan a deploy or a destroy of `stack`. A filtered deploy plan applies to
+ * `undefined` and leaves the persisted stack output untouched. The build,
+ * and the stage's state-store lease, stay open until the surrounding
+ * `Scope` closes.
+ */
+export declare const plan: <Output, Req, const O extends PlanOptions>(input: O & {
+    readonly stack: Stack.ConfiguredStack<Output, Req>;
+}) => Effect.Effect<StackPlan<PlanOutput<Output, O>>, import("effect/Config").ConfigError | import("effect/PlatformError").PlatformError, AlchemyContext | import("effect/process/ChildProcessSpawner").ChildProcessSpawner | import("../Auth/Credentials.ts").CredentialsStore | import("effect/crypto/Digest").Digest | import("effect/FileSystem").FileSystem | import("effect/http/HttpClient").HttpClient | import("../Interaction.ts").Interaction | import("effect/Path").Path | import("../Auth/Profile.ts").ProfileStore | import("effect/Scope").Scope | import("effect/crypto/SecureRandom").SecureRandom>;
+/** Run a plan; a deploy returns the stack's output. */
+export declare const apply: <Output>(plan: StackPlan<Output>) => Effect.Effect<import("../Input.ts").Input.Resolve<Output>, import("../Auth/AuthProvider.ts").AuthError | import("effect/Config").ConfigError | import("../Auth/Demand.ts").CredentialsRequired | Apply.DestroyError | import("../Output.ts").InvalidReferenceError | import("../Output.ts").MissingSourceError | import("../Auth/AuthProvider.ts").NeedsReauth | import("effect/PlatformError").PlatformError | import("../State/State.ts").StateStoreError, never>;
+/** Stage used when a stack's providers are built without addressing a deployment. */
+export declare const PLACEHOLDER_STAGE = "placeholder";
+/**
+ * Build a stack's providers and state store without running its program or
+ * addressing a stage: what account-wide operations like `Nuke.scan` need.
+ */
+export declare const buildProviders: <Req>(stack: Stack.ConfiguredStack<unknown, Req>, options?: ConfigOptions) => Effect.Effect<Context.Context<AdoptPolicy | AlchemyContext | ArtifactStore | import("../index.ts").AuthProviders | Stack.Stack | Stage | State | Exclude<Extract<Req, Stack.ProviderServices>, Tracer.ParentSpan>>, import("effect/Config").ConfigError | import("effect/PlatformError").PlatformError, AlchemyContext | import("effect/process/ChildProcessSpawner").ChildProcessSpawner | import("../Auth/Credentials.ts").CredentialsStore | import("effect/crypto/Digest").Digest | import("effect/FileSystem").FileSystem | import("effect/http/HttpClient").HttpClient | import("../Interaction.ts").Interaction | import("effect/Path").Path | import("../Auth/Profile.ts").ProfileStore | import("effect/Scope").Scope | import("effect/crypto/SecureRandom").SecureRandom>;
+export {};
+//# sourceMappingURL=Operations.d.ts.map

package/lib/Alchemist/Operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Operations.d.ts","sourceRoot":"","sources":["../../src/Alchemist/Operations.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAItC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,KAAK,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,aAAa,EAAuB,MAAM,iBAAiB,CAAC;AAErE,OAAO,EAAQ,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,KAAK,IAAI,MAAM,YAAY,CAAC;AACnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,KAAK,KAAK,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAG/C,uDAAuD;AACvD,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,gFAAgF;IAChF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,yEAAyE;IACzE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,4DAA4D;IAC5D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED,mDAAmD;AACnD,eAAO,MAAM,cAAc,mKAczB,CAAC;AA4CH;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAA2C,MAAM,EAAE,GAAG;;IAQzE,2EAA2E;;8KAG7E,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAyD,GAAG;;;;;;;;;;;;;;;;kiBAkB1F,CAAC;AAEH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,6BAA6B;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,6FAA6F;AAC7F,eAAO,MAAM,UAAU,gBAAiB;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAA;CAAE,KAAG,OAQzE,CAAC;AAEJ,eAAO,MAAM,SAAS,SAAU,IAAI,CAAC,IAAI,KAAG,WAiB3C,CAAC;AAEF,kDAAkD;AAClD,KAAK,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC;AAEjE;;;GAGG;AACH,MAAM,WAAW,SAAS,CAAC,MAAM,GAAG,OAAO;IACzC,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IACnD,sCAAsC;IACtC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IAC/C;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;CAChC;AAED,yDAAyD;AACzD,eAAO,MAAM,iBAAiB,GAAuD,MAAM;oBAEvE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE;sBAC/C,YAAY;;;;;QAMrB,IAAI;QAAoB,KAAK;;;;;gBAMxC,CAAC;AAEH;;;GAGG;AACH,MAAM,WAAW,iBAAkB,SAAQ,YAAY,EAAE,iBAAiB;IACxE,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC;IAC7B,qDAAqD;IACrD,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACtD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC/B;AAED,MAAM,MAAM,WAAW,GAAG,iBAAiB,GAAG,kBAAkB,CAAC;AAEjE,kDAAkD;AAClD,MAAM,MAAM,UAAU,CAAC,MAAM,EAAE,CAAC,SAAS,WAAW,IAAI,CAAC,SAAS;IAAE,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;CAAE,GAC/F,SAAS,GACT,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AAE/B;;;;;GAKG;AACH,eAAO,MAAM,IAAI,GACf,MAAM,EACN,GAAG,QACG,CAAC,SAAS,WAAW;oBACE,KAAK,CAAC,eAAe,CAAC,MAAM,EAAE,GAAG,CAAC;qlBAiB/D,CAAC;AAEH,uDAAuD;AACvD,eAAO,MAAM,KAAK,GAA2C,MAAM,ieAEjE,CAAC;AAEH,qFAAqF;AACrF,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,GAAG,SACzB,KAAK,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,YACjC,aAAa,wvBAKrB,CAAC"}