alchemy 2.0.0-beta.57 → 2.0.0-beta.59

package/lib/Command/Command.js

@@ -0,0 +1,118 @@
+/**
+ * Contains props, error tags, and the live service for executing commands.
+ * Shared between the `Build`, `Dev`, and `Exec` resources.
+ */
+import * as Context from "effect/Context";
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+import { flow } from "effect/Function";
+import * as Layer from "effect/Layer";
+import * as Path from "effect/Path";
+import { BadArgument } from "effect/PlatformError";
+import * as Predicate from "effect/Predicate";
+import * as Redacted from "effect/Redacted";
+import * as Sink from "effect/Sink";
+import * as Stream from "effect/Stream";
+import * as ChildProcess from "effect/unstable/process/ChildProcess";
+import * as ChildProcessSpawner from "effect/unstable/process/ChildProcessSpawner";
+import { isNonInteractive } from "../Util/interactive.js";
+export class CommandExecutor extends Context.Service()("alchemy/Command/CommandExecutor") {
+}
+/**
+ * Extends Effect's `PlatformError` to include the command that failed and some command-specific error reasons.
+ */
+export class CommandError extends Data.TaggedError("CommandError") {
+    constructor({ command, reason, }) {
+        if ("cause" in reason) {
+            super({ command, reason, cause: reason.cause });
+        }
+        else {
+            super({ command, reason });
+        }
+    }
+    get message() {
+        return `Failed to execute command "${this.command}": ${this.reason.message}`;
+    }
+}
+export const isCommandError = (error) => Predicate.isTagged(error, "CommandError");
+/**
+ * Represents when a command exits unexpectedly.
+ */
+export class UnexpectedExit extends Data.TaggedError("UnexpectedExit") {
+    get message() {
+        return `The command exited with code ${this.exitCode}. Standard error output: ${this.stderr}`;
+    }
+}
+/**
+ * Represents when the output directory does not exist.
+ */
+export class OutputNotFound extends Data.TaggedError("OutputNotFound") {
+    get message() {
+        return `The output directory "${this.outdir}" does not exist.`;
+    }
+}
+export const CommandExecutorLive = () => Layer.effect(CommandExecutor, Effect.gen(function* () {
+    const path = yield* Path.Path;
+    const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+    /** Parses a command string into a binary and arguments, unless {@link CommandProps.shell} is true. */
+    const parseCommand = (props) => {
+        if (props.shell) {
+            return Effect.succeed({ bin: props.command, args: [] });
+        }
+        const [bin, ...args] = props.command
+            .split(/(\s+)/)
+            .filter((part) => !!part.trim());
+        if (!bin) {
+            return Effect.fail(new CommandError({
+                command: props.command,
+                reason: new BadArgument({
+                    module: "Command",
+                    method: "parseCommand",
+                    description: "Command is empty",
+                }),
+            }));
+        }
+        return Effect.succeed({ bin, args });
+    };
+    /** Spawns a command, returning the child process handle. */
+    const spawn = (props) => parseCommand(props).pipe(Effect.flatMap(({ bin, args }) => spawner.spawn(ChildProcess.make(bin, args, {
+        cwd: path.resolve(props.cwd ?? process.cwd()),
+        shell: props.shell ?? false,
+        env: Object.fromEntries(Object.entries(props.env ?? {}).map(([k, v]) => [
+            k,
+            Redacted.isRedacted(v) ? Redacted.value(v) : v,
+        ])),
+        extendEnv: true,
+        stdin: isNonInteractive() ? "ignore" : "inherit",
+        stdout: "pipe",
+        stderr: "pipe",
+        detached: false,
+    }))), mapError(props.command));
+    /** Collects the output of a stream, tapping each line to a sink. */
+    const collect = (stream, tap) => stream.pipe(Stream.decodeText, Stream.tapSink(Sink.make()(flow(Stream.splitLines, Stream.runForEach(tap)))), Stream.mkString);
+    /** Maps a PlatformError to a CommandError. */
+    const mapError = (command) => Effect.mapError((error) => error._tag === "CommandError"
+        ? error
+        : new CommandError({
+            command,
+            reason: error.reason,
+        }));
+    return CommandExecutor.of({
+        spawn,
+        /** Executes a command, returning the exit code, stdout, and stderr. */
+        run: (props, session) => spawn(props).pipe(Effect.flatMap((child) => Effect.all({
+            exitCode: child.exitCode,
+            stdout: collect(child.stdout, session.note),
+            stderr: collect(child.stderr, session.note),
+        }, { concurrency: "unbounded" }).pipe(mapError(props.command))), Effect.tap(({ exitCode, stderr }) => exitCode !== 0
+            ? Effect.fail(new CommandError({
+                command: props.command,
+                reason: new UnexpectedExit({
+                    exitCode,
+                    stderr,
+                }),
+            }))
+            : Effect.void), Effect.scoped),
+    });
+}));
+//# sourceMappingURL=Command.js.map

package/lib/Command/Command.js.map

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

package/lib/Command/Dev.d.ts

@@ -0,0 +1,73 @@
+import * as Provider from "../Provider.ts";
+import { Resource } from "../Resource.ts";
+import { CommandExecutor, type CommandProps } from "./Command.ts";
+export interface DevProps extends CommandProps {
+}
+export interface Dev extends Resource<"Command.Dev", DevProps, {
+    /**
+     * URL extracted from the first matching stdout/stderr line. Best-effort:
+     * `undefined` if no URL appears within 5 seconds.
+     */
+    url: string | undefined;
+}> {
+}
+/**
+ * A long-lived shell process scoped to a stack instance, started during
+ * `alchemy dev` and restarted when its inputs change. During `alchemy deploy`
+ * this is a no-op — `Dev` resources only run in dev mode.
+ *
+ * The child process runs inside the dev sidecar (see `Command/Local.ts`) so it
+ * survives user-code HMR — Alchemy's user process can restart without killing
+ * your `npm run dev` server. Its stdout/stderr are mirrored to the terminal
+ * (preserving colored output) and each line is scanned for the first
+ * `http(s)://…` URL, which is exposed as the `url` output attribute — useful
+ * for surfacing a dev server's local URL back out to whatever resource
+ * declared this `Dev`.
+ *
+ * @resource
+ *
+ * @section Basic Usage
+ * Pass a shell command that starts a long-lived dev server. Alchemy
+ * runs it in the background and extracts the first URL it prints.
+ *
+ * @example Start a Vite dev server
+ * ```typescript
+ * const dev = yield* Dev("Frontend", {
+ *   command: "npm run dev",
+ * });
+ * yield* Console.log(dev.url); // e.g. "http://localhost:5173"
+ * ```
+ *
+ * @section Working Directory
+ * Use `cwd` to run the command in a subdirectory — useful in
+ * monorepos where each package has its own dev server.
+ *
+ * @example Monorepo package
+ * ```typescript
+ * const dev = yield* Dev("Web", {
+ *   command: "npm run dev",
+ *   cwd: "apps/web",
+ * });
+ * ```
+ *
+ * @section Environment Variables
+ * Extra environment variables are merged on top of `process.env`.
+ * Sensitive values can be wrapped in `Redacted` to keep them out
+ * of logs and state files.
+ *
+ * @example Custom port and env
+ * ```typescript
+ * const dev = yield* Dev("Api", {
+ *   command: "npm run dev",
+ *   env: {
+ *     PORT: "4000",
+ *     DATABASE_URL: Redacted.make("postgres://..."),
+ *   },
+ * });
+ * ```
+ */
+export declare const Dev: import("../Resource.ts").ResourceClass<Dev>;
+export declare const DevProvider: () => import("effect/Layer").Layer<Provider.Provider<Dev>, never, import("../AlchemyContext.ts").AlchemyContext | import("../Artifacts.ts").ArtifactStore | CommandExecutor | import("effect/Scope").Scope | import("../Stack.ts").Stack>;
+export declare const DevProviderLive: () => import("effect/Layer").Layer<Provider.Provider<Dev>, never, never>;
+export declare const DevProviderLocal: () => import("effect/Layer").Layer<Provider.Provider<Dev>, never, import("../AlchemyContext.ts").AlchemyContext | import("../Artifacts.ts").ArtifactStore | CommandExecutor | import("effect/Scope").Scope | import("../Stack.ts").Stack>;
+//# sourceMappingURL=Dev.d.ts.map

package/lib/Command/Dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Dev.d.ts","sourceRoot":"","sources":["../../src/Command/Dev.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAEL,eAAe,EAEf,KAAK,YAAY,EAClB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,QAAS,SAAQ,YAAY;CAAG;AAEjD,MAAM,WAAW,GAAI,SAAQ,QAAQ,CACnC,aAAa,EACb,QAAQ,EACR;IACE;;;OAGG;IACH,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CACzB,CACF;CAAG;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,eAAO,MAAM,GAAG,6CAA+B,CAAC;AAEhD,eAAO,MAAM,WAAW,2OAIpB,CAAC;AAEL,eAAO,MAAM,eAAe,0EAMxB,CAAC;AAEL,eAAO,MAAM,gBAAgB,2OAwG1B,CAAC"}

package/lib/Command/Dev.js

@@ -0,0 +1,145 @@
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as FiberMap from "effect/FiberMap";
+import * as Hash from "effect/Hash";
+import * as Stream from "effect/Stream";
+import { isResolved } from "../Diff.js";
+import * as ProviderLayer from "../Local/ProviderLayer.js";
+import * as RpcProvider from "../Local/RpcProvider.js";
+import * as Provider from "../Provider.js";
+import { Resource } from "../Resource.js";
+import { CommandError, CommandExecutor, UnexpectedExit, } from "./Command.js";
+/**
+ * A long-lived shell process scoped to a stack instance, started during
+ * `alchemy dev` and restarted when its inputs change. During `alchemy deploy`
+ * this is a no-op — `Dev` resources only run in dev mode.
+ *
+ * The child process runs inside the dev sidecar (see `Command/Local.ts`) so it
+ * survives user-code HMR — Alchemy's user process can restart without killing
+ * your `npm run dev` server. Its stdout/stderr are mirrored to the terminal
+ * (preserving colored output) and each line is scanned for the first
+ * `http(s)://…` URL, which is exposed as the `url` output attribute — useful
+ * for surfacing a dev server's local URL back out to whatever resource
+ * declared this `Dev`.
+ *
+ * @resource
+ *
+ * @section Basic Usage
+ * Pass a shell command that starts a long-lived dev server. Alchemy
+ * runs it in the background and extracts the first URL it prints.
+ *
+ * @example Start a Vite dev server
+ * ```typescript
+ * const dev = yield* Dev("Frontend", {
+ *   command: "npm run dev",
+ * });
+ * yield* Console.log(dev.url); // e.g. "http://localhost:5173"
+ * ```
+ *
+ * @section Working Directory
+ * Use `cwd` to run the command in a subdirectory — useful in
+ * monorepos where each package has its own dev server.
+ *
+ * @example Monorepo package
+ * ```typescript
+ * const dev = yield* Dev("Web", {
+ *   command: "npm run dev",
+ *   cwd: "apps/web",
+ * });
+ * ```
+ *
+ * @section Environment Variables
+ * Extra environment variables are merged on top of `process.env`.
+ * Sensitive values can be wrapped in `Redacted` to keep them out
+ * of logs and state files.
+ *
+ * @example Custom port and env
+ * ```typescript
+ * const dev = yield* Dev("Api", {
+ *   command: "npm run dev",
+ *   env: {
+ *     PORT: "4000",
+ *     DATABASE_URL: Redacted.make("postgres://..."),
+ *   },
+ * });
+ * ```
+ */
+export const Dev = Resource("Command.Dev");
+export const DevProvider = () => ProviderLayer.select({
+    live: DevProviderLive,
+    local: DevProviderLocal,
+});
+export const DevProviderLive = () => Provider.succeed(Dev, {
+    list: () => Effect.succeed([]),
+    diff: () => Effect.succeed({ action: "noop" }),
+    reconcile: () => Effect.succeed({ url: undefined }),
+    delete: () => Effect.void,
+});
+export const DevProviderLocal = () => RpcProvider.effect(Dev, import.meta.resolve(import.meta.url.endsWith(".ts") ? "./Local.ts" : "./Local.js", import.meta.url), Effect.gen(function* () {
+    const { spawn } = yield* CommandExecutor;
+    const map = yield* FiberMap.make();
+    const hashes = new Map();
+    const spawnAndExtractResult = Effect.fn(function* (props, urlDeferred) {
+        const child = yield* spawn(props);
+        let buffer = "";
+        const deferred = yield* Deferred.make();
+        const mirror = (sink) => child[sink].pipe(Stream.tap((chunk) => Effect.sync(() => process[sink].write(chunk))), Stream.decodeText, Stream.tap((text) => Effect.sync(() => {
+            if (Deferred.isDoneUnsafe(deferred))
+                return;
+            buffer += text;
+            const url = extractUrl(buffer);
+            if (url) {
+                Deferred.doneUnsafe(deferred, Effect.succeed(url));
+            }
+        })), Stream.runDrain, Effect.forkScoped);
+        yield* mirror("stdout");
+        yield* mirror("stderr");
+        yield* Effect.raceAllFirst([
+            Deferred.await(deferred).pipe(Effect.timeoutOrElse({
+                duration: "5 seconds",
+                orElse: () => Effect.undefined,
+            })),
+            child.exitCode.pipe(Effect.mapError((error) => new CommandError({
+                command: props.command,
+                reason: error.reason,
+            })), Effect.flatMap((exitCode) => new CommandError({
+                command: props.command,
+                reason: new UnexpectedExit({ exitCode, stderr: buffer }),
+            }))),
+        ]).pipe(Deferred.into(urlDeferred));
+        return yield* child.exitCode;
+    }, Effect.scoped);
+    return {
+        list: () => Effect.succeed([]),
+        diff: Effect.fn(function* ({ instanceId, news }) {
+            if (!isResolved(news))
+                return undefined;
+            const hash = Hash.structure(news);
+            if (hashes.get(instanceId) === hash &&
+                (yield* FiberMap.has(map, instanceId))) {
+                return { action: "noop" };
+            }
+            return { action: "update" };
+        }),
+        reconcile: Effect.fn(function* ({ instanceId, news }) {
+            const hash = Hash.structure(news);
+            hashes.set(instanceId, hash);
+            const deferred = yield* Deferred.make();
+            yield* FiberMap.run(map, instanceId, spawnAndExtractResult(news, deferred), { propagateInterruption: true });
+            return { url: yield* Deferred.await(deferred) };
+        }),
+        delete: Effect.fn(function* ({ instanceId }) {
+            yield* FiberMap.remove(map, instanceId);
+            hashes.delete(instanceId);
+        }),
+    };
+}));
+// Matches the first plain http(s) URL. Stops at whitespace and at a small
+// set of punctuation typically used to wrap URLs in log output.
+const URL_REGEX = /https?:\/\/[^\s)\],"'`]+/;
+// ECMA-262 ANSI/VT100 escape sequences — `Vite`, `Next`, etc. surround the
+// URL with color codes that would otherwise be eaten by the URL regex.
+// eslint-disable-next-line no-control-regex
+const ANSI_REGEX = /\x1b\[[0-9;]*m/g;
+const extractUrl = (text) => text.replaceAll(ANSI_REGEX, "").match(URL_REGEX)?.[0];
+//# sourceMappingURL=Dev.js.map

package/lib/Command/Dev.js.map

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

package/lib/Command/Exec.d.ts

@@ -0,0 +1,70 @@
+import * as Provider from "../Provider.ts";
+import { Resource } from "../Resource.ts";
+import { CommandExecutor, type CommandProps } from "./Command.ts";
+import { type MemoOptions } from "./Memo.ts";
+export interface ExecProps extends CommandProps {
+    /**
+     * Controls which files are hashed to decide whether the command should
+     * re-run. By default every non-gitignored file in `cwd` is hashed, plus the
+     * nearest lockfile. Provide explicit globs to narrow the scope, or set
+     * `false` to disable memoization and re-run on every deploy.
+     *
+     * @see {@link MemoOptions}
+     * @default true
+     */
+    memo?: MemoOptions | boolean;
+}
+export interface Exec extends Resource<"Command.Exec", ExecProps, {
+    /**
+     * Hash of the input files for this command, if memoization is enabled.
+     */
+    hash: {
+        input: string | undefined;
+    };
+}> {
+}
+/**
+ * An `Exec` runs a shell command purely for its side effects — it has no
+ * output contract. Unlike `Build`, it does not produce or track an output
+ * asset; `reconcile` runs the command and the resource succeeds as long as the
+ * command exits with code `0` (a non-zero exit fails with a `CommandError`).
+ *
+ * Use it for one-off setup steps — running migrations, seeding data, code
+ * generation, or any command whose result lives outside Alchemy's state. By
+ * default the input files are content-hashed so the command only re-runs when
+ * its inputs (or `command`/`cwd`/`env`) change; set `memo: false` to re-run on
+ * every deploy.
+ *
+ * @resource
+ * @section Running a Command
+ * @example Run a One-Off Command
+ * ```typescript
+ * yield* Exec("codegen", {
+ *   command: "npm run codegen",
+ *   cwd: "./packages/api",
+ * });
+ * ```
+ *
+ * @section Running with Custom Environment
+ * @example Run Database Migrations
+ * ```typescript
+ * yield* Exec("migrate", {
+ *   command: "npm run db:migrate",
+ *   env: {
+ *     DATABASE_URL: Redacted.make("postgres://..."),
+ *   },
+ * });
+ * ```
+ *
+ * @section Memoizing Re-Runs
+ * @example Only Re-Run When Inputs Change
+ * ```typescript
+ * yield* Exec("codegen", {
+ *   command: "npm run codegen",
+ *   memo: { include: ["schema/**"] },
+ * });
+ * ```
+ */
+export declare const Exec: import("../Resource.ts").ResourceClass<Exec>;
+export declare const ExecProvider: () => import("effect/Layer").Layer<Provider.Provider<Exec>, never, CommandExecutor | import("effect/FileSystem").FileSystem | import("effect/Path").Path>;
+//# sourceMappingURL=Exec.d.ts.map

package/lib/Command/Exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Exec.d.ts","sourceRoot":"","sources":["../../src/Command/Exec.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAE5D,MAAM,WAAW,SAAU,SAAQ,YAAY;IAC7C;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,IAAK,SAAQ,QAAQ,CACpC,cAAc,EACd,SAAS,EACT;IACE;;OAEG;IACH,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;KAC3B,CAAC;CACH,CACF;CAAG;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,eAAO,MAAM,IAAI,8CAAiC,CAAC;AAEnD,eAAO,MAAM,YAAY,2JA2CtB,CAAC"}

package/lib/Command/Exec.js

@@ -0,0 +1,87 @@
+import * as Effect from "effect/Effect";
+import { havePropsChanged, isResolved } from "../Diff.js";
+import * as Provider from "../Provider.js";
+import { Resource } from "../Resource.js";
+import { CommandExecutor } from "./Command.js";
+import { hashDirectory } from "./Memo.js";
+/**
+ * An `Exec` runs a shell command purely for its side effects — it has no
+ * output contract. Unlike `Build`, it does not produce or track an output
+ * asset; `reconcile` runs the command and the resource succeeds as long as the
+ * command exits with code `0` (a non-zero exit fails with a `CommandError`).
+ *
+ * Use it for one-off setup steps — running migrations, seeding data, code
+ * generation, or any command whose result lives outside Alchemy's state. By
+ * default the input files are content-hashed so the command only re-runs when
+ * its inputs (or `command`/`cwd`/`env`) change; set `memo: false` to re-run on
+ * every deploy.
+ *
+ * @resource
+ * @section Running a Command
+ * @example Run a One-Off Command
+ * ```typescript
+ * yield* Exec("codegen", {
+ *   command: "npm run codegen",
+ *   cwd: "./packages/api",
+ * });
+ * ```
+ *
+ * @section Running with Custom Environment
+ * @example Run Database Migrations
+ * ```typescript
+ * yield* Exec("migrate", {
+ *   command: "npm run db:migrate",
+ *   env: {
+ *     DATABASE_URL: Redacted.make("postgres://..."),
+ *   },
+ * });
+ * ```
+ *
+ * @section Memoizing Re-Runs
+ * @example Only Re-Run When Inputs Change
+ * ```typescript
+ * yield* Exec("codegen", {
+ *   command: "npm run codegen",
+ *   memo: { include: ["schema/**"] },
+ * });
+ * ```
+ */
+export const Exec = Resource("Command.Exec");
+export const ExecProvider = () => Provider.effect(Exec, Effect.gen(function* () {
+    const { run } = yield* CommandExecutor;
+    return {
+        list: () => Effect.succeed([]),
+        diff: Effect.fn(function* ({ olds, news, output }) {
+            if (!output || !isResolved(news))
+                return undefined;
+            // Always update if memoization is disabled or input hash is not available.
+            if (news.memo === false || !output.hash.input)
+                return { action: "update" };
+            // Optimization: short-circuit if props have changed to avoid unnecessary file system operations.
+            if (havePropsChanged(olds, news))
+                return { action: "update" };
+            const newHash = yield* hashDirectory({
+                cwd: news.cwd,
+                memo: news.memo === true ? {} : news.memo,
+            });
+            return {
+                action: newHash === output.hash.input ? "noop" : "update",
+            };
+        }),
+        reconcile: Effect.fn(function* ({ news, session }) {
+            yield* run(news, session);
+            return {
+                hash: {
+                    input: news.memo === false
+                        ? undefined
+                        : yield* hashDirectory({
+                            cwd: news.cwd,
+                            memo: news.memo === true ? {} : news.memo,
+                        }),
+                },
+            };
+        }),
+        delete: () => Effect.void,
+    };
+}));
+//# sourceMappingURL=Exec.js.map

package/lib/Command/Exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Exec.js","sourceRoot":"","sources":["../../src/Command/Exec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAqB,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,aAAa,EAAoB,MAAM,WAAW,CAAC;AA4B5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,QAAQ,CAAO,cAAc,CAAC,CAAC;AAEnD,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,EAAE,CAC/B,QAAQ,CAAC,MAAM,CACb,IAAI,EACJ,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,eAAe,CAAC;IAEvC,OAAO;QACL,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE;YAC/C,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,OAAO,SAAS,CAAC;YAEnD,2EAA2E;YAC3E,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK;gBAC3C,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;YAE9B,iGAAiG;YACjG,IAAI,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC;gBAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;YAE9D,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,aAAa,CAAC;gBACnC,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI;aAC1C,CAAC,CAAC;YACH,OAAO;gBACL,MAAM,EAAE,OAAO,KAAK,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;aAC1D,CAAC;QACJ,CAAC,CAAC;QACF,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;YAC/C,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC1B,OAAO;gBACL,IAAI,EAAE;oBACJ,KAAK,EACH,IAAI,CAAC,IAAI,KAAK,KAAK;wBACjB,CAAC,CAAC,SAAS;wBACX,CAAC,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC;4BACnB,GAAG,EAAE,IAAI,CAAC,GAAG;4BACb,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI;yBAC1C,CAAC;iBACT;aACF,CAAC;QACJ,CAAC,CAAC;QACF,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI;KAC1B,CAAC;AACJ,CAAC,CAAC,CACH,CAAC"}

package/lib/Command/Local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Local.d.ts","sourceRoot":"","sources":["../../src/Command/Local.ts"],"names":[],"mappings":""}

package/lib/Command/Local.js

@@ -0,0 +1,6 @@
+import * as Layer from "effect/Layer";
+import * as RpcServer from "../Local/RpcServer.js";
+import { CommandExecutorLive } from "./Command.js";
+import { DevProviderLocal } from "./Dev.js";
+DevProviderLocal().pipe(Layer.provide(CommandExecutorLive()), RpcServer.launch);
+//# sourceMappingURL=Local.js.map

package/lib/Command/Local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Local.js","sourceRoot":"","sources":["../../src/Command/Local.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,SAAS,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,gBAAgB,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC"}

package/lib/Command/Memo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Memo.d.ts","sourceRoot":"","sources":["../../src/Command/Memo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAK1D;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAmID;;;;GAIG;AACH,eAAO,MAAM,aAAa;UAClB,MAAM;WACL,WAAW;6EAUlB,CAAC"}

package/lib/Command/Memo.js

@@ -0,0 +1,89 @@
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import fg from "fast-glob";
+import { gitignoreRulesToGlobs } from "../Util/gitignore-rules-to-globs.js";
+import { sha256, sha256Object } from "../Util/sha256.js";
+/**
+ * Internal service that resolves memo options, lists matching files, and
+ * produces a single SHA-256 content hash. Constructed as an Effect so it
+ * can access the platform `FileSystem` and `Path` services.
+ */
+const Memo = Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const findUp = Effect.fn(function* (cwd, filenames) {
+        const [file] = yield* Effect.filter(filenames.map((filename) => path.join(cwd, filename)), fs.exists, { concurrency: "unbounded" });
+        if (file) {
+            return file;
+        }
+        const parent = path.dirname(cwd);
+        if (parent === cwd) {
+            return undefined;
+        }
+        return yield* findUp(parent, filenames);
+    });
+    const readGitIgnoreRules = Effect.fn(function* (cwd) {
+        const rules = yield* fs.readFileString(path.join(cwd, ".gitignore")).pipe(Effect.map((file) => file.split("\n")), Effect.catchIf((error) => error._tag === "PlatformError" && error.reason._tag === "NotFound", () => Effect.succeed([])));
+        const parent = path.dirname(cwd);
+        if (parent === cwd || (yield* fs.exists(path.join(cwd, ".git")))) {
+            return rules;
+        }
+        return [...(yield* readGitIgnoreRules(parent)), ...rules];
+    });
+    const resolveMemoOptions = Effect.fn(function* (cwd, options) {
+        const resolvedCwd = cwd ? path.resolve(cwd) : process.cwd();
+        return {
+            cwd: resolvedCwd,
+            include: options.include ?? ["**/*"],
+            exclude: options.exclude ??
+                (yield* readGitIgnoreRules(resolvedCwd).pipe(Effect.map(gitignoreRulesToGlobs), Effect.map((globs) => ["**/.git/**", ...globs]))),
+            lockfile: options.lockfile ?? !(options.exclude || options.include),
+        };
+    });
+    const listFiles = Effect.fn(function* (options) {
+        const [files, lockfile] = yield* Effect.all([
+            Effect.promise(() => fg.glob(options.include, {
+                cwd: options.cwd,
+                ignore: options.exclude,
+                onlyFiles: true,
+                dot: true,
+            })),
+            options.lockfile
+                ? findUp(options.cwd, [
+                    "bun.lock",
+                    "bun.lockb",
+                    "package-lock.json",
+                    "pnpm-lock.yaml",
+                    "yarn.lock",
+                ]).pipe(Effect.map((lockfile) => lockfile ? path.relative(options.cwd, lockfile) : undefined))
+                : Effect.succeed(undefined),
+        ], { concurrency: "unbounded" });
+        if (lockfile && !files.includes(lockfile)) {
+            files.push(lockfile);
+        }
+        return files.sort();
+    });
+    const hashFiles = Effect.fn(function* (cwd, files) {
+        const hashes = yield* Effect.forEach(files, (file) => fs.readFile(path.join(cwd, file)).pipe(Effect.flatMap(sha256), Effect.map((hash) => `${file}:${hash}`)), { concurrency: "unbounded" });
+        return yield* sha256Object(hashes);
+    });
+    return {
+        resolveMemoOptions,
+        listFiles,
+        hashFiles,
+    };
+});
+/**
+ * Produces a deterministic SHA-256 hash of all files matched by the given
+ * memo options. The hash changes if and only if the content of the matched
+ * files changes, making it suitable for cache-busting build outputs.
+ */
+export const hashDirectory = Effect.fn(function* (props) {
+    const service = yield* Memo;
+    const resolvedOptions = yield* service.resolveMemoOptions(props.cwd, props.memo ?? {});
+    const files = yield* service.listFiles(resolvedOptions);
+    const hash = yield* service.hashFiles(resolvedOptions.cwd, files);
+    return hash;
+});
+//# sourceMappingURL=Memo.js.map

package/lib/Command/Memo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Memo.js","sourceRoot":"","sources":["../../src/Command/Memo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAEpC,OAAO,EAAE,MAAM,WAAW,CAAC;AAC3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAyCzD;;;;GAIG;AACH,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAC/B,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IACxC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAE9B,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAChC,GAAW,EACX,SAAmB;QAEnB,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CACjC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,EACrD,EAAE,CAAC,MAAM,EACT,EAAE,WAAW,EAAE,WAAW,EAAE,CAC7B,CAAC;QACF,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,MAAM,kBAAkB,GAAG,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAC5C,GAAW;QAEX,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,CACvE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EACtC,MAAM,CAAC,OAAO,CACZ,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,IAAI,KAAK,eAAe,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,EACpE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CACzB,CACF,CAAC;QACF,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,MAAM,kBAAkB,GAAG,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAC5C,GAAuB,EACvB,OAAoB;QAEpB,MAAM,WAAW,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QAC5D,OAAO;YACL,GAAG,EAAE,WAAW;YAChB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC;YACpC,OAAO,EACL,OAAO,CAAC,OAAO;gBACf,CAAC,KAAK,CAAC,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,IAAI,CAC1C,MAAM,CAAC,GAAG,CAAC,qBAAqB,CAAC,EACjC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,YAAY,EAAE,GAAG,KAAK,CAAC,CAAC,CAChD,CAAC;YACJ,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;SACpE,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EACnC,OAA4B;QAE5B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CACzC;YACE,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAClB,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE;gBACvB,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,MAAM,EAAE,OAAO,CAAC,OAAO;gBACvB,SAAS,EAAE,IAAI;gBACf,GAAG,EAAE,IAAI;aACV,CAAC,CACH;YACD,OAAO,CAAC,QAAQ;gBACd,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE;oBAClB,UAAU;oBACV,WAAW;oBACX,mBAAmB;oBACnB,gBAAgB;oBAChB,WAAW;iBACZ,CAAC,CAAC,IAAI,CACL,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CACtB,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAC5D,CACF;gBACH,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;SAC9B,EACD,EAAE,WAAW,EAAE,WAAW,EAAE,CAC7B,CAAC;QACF,IAAI,QAAQ,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EACnC,GAAW,EACX,KAAe;QAEf,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAClC,KAAK,EACL,CAAC,IAAI,EAAE,EAAE,CACP,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CACpC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EACtB,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CACxC,EACH,EAAE,WAAW,EAAE,WAAW,EAAE,CAC7B,CAAC;QACF,OAAO,KAAK,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,kBAAkB;QAClB,SAAS;QACT,SAAS;KACV,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,KAGjD;IACC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC;IAC5B,MAAM,eAAe,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,kBAAkB,CACvD,KAAK,CAAC,GAAG,EACT,KAAK,CAAC,IAAI,IAAI,EAAE,CACjB,CAAC;IACF,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAClE,OAAO,IAAI,CAAC;AACd,CAAC,CAAC,CAAC"}

package/lib/Command/Providers.d.ts

@@ -0,0 +1,4 @@
+import * as Layer from "effect/Layer";
+import * as Provider from "../Provider.ts";
+export declare const providers: () => Layer.Layer<Provider.Provider<import("./Build.ts").Build> | Provider.Provider<import("./Dev.ts").Dev> | Provider.Provider<import("./Exec.ts").Exec>, never, import("../AlchemyContext.ts").AlchemyContext | import("../Artifacts.ts").ArtifactStore | import("effect/unstable/process/ChildProcessSpawner").ChildProcessSpawner | import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("effect/Scope").Scope | import("../Stack.ts").Stack>;
+//# sourceMappingURL=Providers.d.ts.map