alchemy 2.0.0-beta.76 → 2.0.0-beta.77

package/lib/Alchemist/routes/profile.js

@@ -0,0 +1,257 @@
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Redacted from "effect/Redacted";
+import { AuthError } from "../../Auth/AuthProvider.js";
+import { CredentialsStore } from "../../Auth/Credentials.js";
+import { inspectProvider, } from "../../Auth/Inspect.js";
+import { withProfileCredentialsLock } from "../../Auth/Lock.js";
+import { ProfileStore } from "../../Auth/Profile.js";
+import { AlchemistInvalidInput, AlchemistNotFound } from "../Errors.js";
+import { Progress } from "../Progress.js";
+import { collectAuthProviders, DEFAULT_ENTRYPOINT, } from "../Session.js";
+/**
+ * Every auth provider reachable from the given project: the built-ins plus
+ * whatever the user's stack module registers.
+ */
+const registry = (input) => collectAuthProviders({
+    main: input.entrypoint ?? DEFAULT_ENTRYPOINT,
+    envFile: Option.fromNullishOr(input.envFile),
+    profile: input.profile,
+});
+/** The effective profile and how it was selected. */
+export const current = Effect.fn("Alchemist.profile.current")(function* () {
+    return yield* (yield* ProfileStore).current;
+});
+/** Every profile with its connected providers, active profile first. */
+export const list = Effect.fn("Alchemist.profile.list")(function* () {
+    const profiles = yield* ProfileStore;
+    const [manifest, selected] = yield* Effect.all([
+        profiles.readManifest,
+        profiles.current,
+    ]);
+    return Object.entries(manifest.profiles)
+        .sort(([a], [b]) => a === "default" ? -1 : b === "default" ? 1 : a.localeCompare(b))
+        .map(([name, profile]) => ({
+        name,
+        active: name === selected.name,
+        providers: Object.entries(profile.providers)
+            .sort(([a], [b]) => a.localeCompare(b))
+            .map(([name, config]) => ({
+            name,
+            method: config.method ?? "unknown",
+        })),
+    }));
+});
+/** One profile with the live status of each connected provider. */
+export const get = Effect.fn("Alchemist.profile.get")(function* (input) {
+    const includeProviderStatus = input.includeProviderStatus ?? true;
+    const profiles = yield* ProfileStore;
+    const [profile, selected] = yield* Effect.all([
+        profiles.getProfile(input.name),
+        profiles.current,
+    ]);
+    if (profile === undefined) {
+        return yield* Effect.fail(new AlchemistNotFound({ kind: "profile", id: input.name }));
+    }
+    // Skipping the status probe is what makes `profile list` fast: it
+    // reaches no provider APIs, so every connection reads as connected.
+    const registered = includeProviderStatus
+        ? yield* registry({
+            profile: input.name,
+            entrypoint: input.entrypoint,
+            envFile: input.envFile,
+        })
+        : {};
+    const entries = Object.entries(profile.providers).sort(([a], [b]) => a.localeCompare(b));
+    return {
+        name: input.name,
+        active: selected.name === input.name,
+        providers: yield* Effect.forEach(entries, ([provider, config]) => includeProviderStatus
+            ? inspectProvider(input.name, provider, config, registered, (updated) => profiles.setProviderConfig(input.name, provider, updated).pipe(Effect.mapError((cause) => new AuthError({
+                message: `Could not persist repaired ${provider} credentials for profile '${input.name}'.`,
+                cause,
+            }))))
+            : Effect.succeed({
+                name: provider,
+                method: config.method ?? "unknown",
+                status: "connected",
+                details: [],
+            })),
+    };
+});
+export const create = Effect.fn("Alchemist.profile.create")(function* (input) {
+    yield* (yield* ProfileStore).createProfile(input.name);
+    return yield* get({ name: input.name });
+});
+export const rename = Effect.fn("Alchemist.profile.rename")(function* (input) {
+    yield* (yield* ProfileStore).renameProfile(input.name, input.newName);
+    return yield* get({ name: input.newName });
+});
+/** Delete a profile and every credential stored for it. */
+export const deleteProfile = Effect.fn("Alchemist.profile.delete")(function* (input) {
+    const profiles = yield* ProfileStore;
+    const credentials = yield* CredentialsStore;
+    return yield* withProfileCredentialsLock(input.name, Effect.gen(function* () {
+        const deleted = yield* profiles.deleteProfile(input.name);
+        if (!deleted) {
+            return yield* Effect.fail(new AlchemistNotFound({ kind: "profile", id: input.name }));
+        }
+        yield* credentials.deleteProfile(input.name);
+        return { name: input.name, credentialsDeleted: true };
+    }));
+});
+/** Every registered auth provider and how it can be configured. */
+export const providers = Effect.fn("Alchemist.profile.providers")(function* (input) {
+    const profiles = yield* ProfileStore;
+    const profile = input.profile ?? (yield* profiles.current).name;
+    const stored = yield* profiles.ensureProfile(profile);
+    const registered = yield* registry({ ...input, profile });
+    return Object.values(registered)
+        .sort((a, b) => a.name.localeCompare(b.name))
+        .map((provider) => ({
+        name: provider.name,
+        connected: provider.name in stored.providers,
+        configureMethods: (provider.configureMethods ?? []).map((method) => ({
+            method: method.method,
+            label: method.method,
+            fields: method.fields.map((field) => ({
+                name: field.name,
+                label: field.label,
+                secret: field.secret ?? false,
+                required: !(field.optional ?? false),
+                description: field.description,
+                placeholder: field.placeholder,
+            })),
+        })),
+        supportsRefresh: true,
+        supportsLogout: true,
+    }));
+});
+/** The configure methods (and fields) one provider accepts. */
+export const configureForm = Effect.fn("Alchemist.profile.configureForm")(function* (input) {
+    const registered = yield* providers({ profile: input.profile });
+    const provider = registered.find(({ name }) => name === input.provider);
+    if (provider === undefined) {
+        return yield* Effect.fail(new AlchemistNotFound({ kind: "provider", id: input.provider }));
+    }
+    return input.method === undefined
+        ? provider.configureMethods
+        : provider.configureMethods.filter(({ method }) => method === input.method);
+});
+/**
+ * Connect or reconfigure a provider in a profile. Reported through
+ * {@link Progress} as `ProviderConfigureStarted`; interactive providers drive
+ * their own prompts.
+ */
+export const configure = Effect.fn("Alchemist.profile.configure")(function* (input) {
+    const report = yield* Progress;
+    yield* report({
+        _tag: "provider.configure.started",
+        provider: input.provider,
+    });
+    const profiles = yield* ProfileStore;
+    const stored = yield* profiles.ensureProfile(input.profile);
+    const provider = (yield* registry(input))[input.provider];
+    if (provider === undefined) {
+        return yield* Effect.fail(new AlchemistInvalidInput({
+            field: "provider",
+            message: `Auth provider '${input.provider}' is not registered.`,
+        }));
+    }
+    const connected = input.provider in stored.providers;
+    if ((input.action === "add" && connected) ||
+        (input.action === "reconfigure" && !connected)) {
+        return yield* Effect.fail(new AlchemistInvalidInput({
+            field: "provider",
+            message: `Provider '${input.provider}' is ${connected ? "already" : "not"} connected.`,
+        }));
+    }
+    const config = input.method !== undefined &&
+        input.values !== undefined &&
+        provider.configureWith !== undefined
+        ? yield* provider.configureWith(input.profile, {
+            method: input.method,
+            values: Object.fromEntries(Object.entries(input.values).map(([key, value]) => [
+                key,
+                Redacted.value(value),
+            ])),
+        })
+        : yield* provider.configure(input.profile, connected
+            ? yield* provider
+                .decodeConfig(input.profile, stored.providers[input.provider])
+                .pipe(Effect.orElseSucceed(() => undefined))
+            : undefined);
+    yield* profiles.setProviderConfig(input.profile, input.provider, config);
+    yield* report({
+        _tag: "provider.configure.completed",
+        provider: input.provider,
+    });
+    return yield* get({
+        name: input.profile,
+        entrypoint: input.entrypoint,
+        envFile: input.envFile,
+    });
+});
+/** Log a provider out and disconnect it from the profile. */
+export const removeProvider = Effect.fn("Alchemist.profile.removeProvider")(function* (input) {
+    const profiles = yield* ProfileStore;
+    const stored = yield* profiles.ensureProfile(input.profile);
+    const config = stored.providers[input.provider];
+    if (config === undefined) {
+        return yield* Effect.fail(new AlchemistNotFound({ kind: "provider", id: input.provider }));
+    }
+    const provider = (yield* registry(input))[input.provider];
+    let logout = "unavailable";
+    if (provider !== undefined) {
+        const decoded = yield* provider
+            .decodeConfig(input.profile, config)
+            .pipe(Effect.option);
+        if (Option.isSome(decoded)) {
+            if (input.logout ?? true)
+                yield* provider.logout(input.profile, decoded.value);
+            logout = "completed";
+        }
+        else
+            logout = "skipped-invalid-config";
+    }
+    yield* profiles.deleteProviderConfig(input.profile, input.provider);
+    return { profile: input.profile, provider: input.provider, logout };
+});
+/**
+ * Re-run login for connected providers without reconfiguring them. Each
+ * provider is reported through {@link Progress} as `ProviderRefreshStarted`.
+ */
+export const refresh = Effect.fn("Alchemist.profile.refresh")(function* (input) {
+    const report = yield* Progress;
+    const profiles = yield* ProfileStore;
+    const stored = yield* profiles.ensureProfile(input.profile);
+    const registered = yield* registry(input);
+    const requested = input.providers === undefined || input.providers.length === 0
+        ? Object.keys(stored.providers).sort()
+        : input.providers;
+    for (const name of requested) {
+        const config = stored.providers[name];
+        const provider = registered[name];
+        if (config === undefined || provider === undefined) {
+            return yield* Effect.fail(new AlchemistInvalidInput({
+                field: "providers",
+                message: `Provider '${name}' is not connected or registered.`,
+            }));
+        }
+        yield* report({ _tag: "provider.refresh.started", provider: name });
+        const refreshed = yield* provider.login(input.profile, yield* provider.decodeConfig(input.profile, config), (updated) => profiles.setProviderConfig(input.profile, name, updated).pipe(Effect.mapError((cause) => new AuthError({
+            message: `Could not persist refreshed ${name} credentials for profile '${input.profile}'.`,
+            cause,
+        }))));
+        if (refreshed !== undefined) {
+            yield* profiles.setProviderConfig(input.profile, name, refreshed);
+        }
+        yield* report({ _tag: "provider.refresh.completed", provider: name });
+    }
+    return yield* get({
+        name: input.profile,
+        entrypoint: input.entrypoint,
+        envFile: input.envFile,
+    });
+});
+//# sourceMappingURL=profile.js.map

package/lib/Alchemist/routes/profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../../src/Alchemist/routes/profile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EACL,eAAe,GAEhB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EACL,oBAAoB,EACpB,kBAAkB,GAEnB,MAAM,eAAe,CAAC;AAsDvB;;;GAGG;AACH,MAAM,QAAQ,GAAG,CAAC,KAAsB,EAAE,EAAE,CAC1C,oBAAoB,CAAC;IACnB,IAAI,EAAE,KAAK,CAAC,UAAU,IAAI,kBAAkB;IAC5C,OAAO,EAAE,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC;IAC5C,OAAO,EAAE,KAAK,CAAC,OAAO;CACvB,CAAC,CAAC;AAEL,qDAAqD;AACrD,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC,2BAA2B,CAAC,CAAC,QAAQ,CAAC;IACrE,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC;AAC9C,CAAC,CAAC,CAAC;AAEH,wEAAwE;AACxE,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,wBAAwB,CAAC,CAAC,QAAQ,CAAC;IAC/D,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,YAAY,CAAC;IACrC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QAC7C,QAAQ,CAAC,YAAY;QACrB,QAAQ,CAAC,OAAO;KACjB,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;SACrC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CACjB,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAChE;SACA,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAkB,EAAE,CAAC,CAAC;QACzC,IAAI;QACJ,MAAM,EAAE,IAAI,KAAK,QAAQ,CAAC,IAAI;QAC9B,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;aACzC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;aACtC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;YACxB,IAAI;YACJ,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,SAAS;SACnC,CAAC,CAAC;KACN,CAAC,CAAC,CAAC;AACR,CAAC,CAAC,CAAC;AAEH,mEAAmE;AACnE,MAAM,CAAC,MAAM,GAAG,GAAG,MAAM,CAAC,EAAE,CAAC,uBAAuB,CAAC,CAAC,QAAQ,CAAC,EAAE,KAKhE;IACC,MAAM,qBAAqB,GAAG,KAAK,CAAC,qBAAqB,IAAI,IAAI,CAAC;IAClE,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,YAAY,CAAC;IACrC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QAC5C,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC;QAC/B,QAAQ,CAAC,OAAO;KACjB,CAAC,CAAC;IACH,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACvB,IAAI,iBAAiB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAC3D,CAAC;IACJ,CAAC;IACD,kEAAkE;IAClE,oEAAoE;IACpE,MAAM,UAAU,GAAG,qBAAqB;QACtC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC;YACd,OAAO,EAAE,KAAK,CAAC,IAAI;YACnB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC;QACJ,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAClE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CACnB,CAAC;IACF,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,QAAQ,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI;QACpC,SAAS,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAC9B,OAAO,EACP,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,EAIjB,EAAE,CACF,qBAAqB;YACnB,CAAC,CAAC,eAAe,CACb,KAAK,CAAC,IAAI,EACV,QAAQ,EACR,MAAM,EACN,UAAU,EACV,CAAC,OAAO,EAAE,EAAE,CACV,QAAQ,CAAC,iBAAiB,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,CAC5D,MAAM,CAAC,QAAQ,CACb,CAAC,KAAK,EAAE,EAAE,CACR,IAAI,SAAS,CAAC;gBACZ,OAAO,EAAE,8BAA8B,QAAQ,6BAA6B,KAAK,CAAC,IAAI,IAAI;gBAC1F,KAAK;aACN,CAAC,CACL,CACF,CACJ;YACH,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;gBACb,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,SAAS;gBAClC,MAAM,EAAE,WAAW;gBACnB,OAAO,EAAE,EAAE;aACZ,CAAC,CACT;KACwB,CAAC;AAC9B,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC,0BAA0B,CAAC,CAAC,QAAQ,CAAC,EAAE,KAEtE;IACC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvD,OAAO,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;AAC1C,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC,0BAA0B,CAAC,CAAC,QAAQ,CAAC,EAAE,KAGtE;IACC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACtE,OAAO,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;AAC7C,CAAC,CAAC,CAAC;AAEH,2DAA2D;AAC3D,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,EAAE,CAAC,0BAA0B,CAAC,CAChE,QAAQ,CAAC,EAAE,KAAgC;IACzC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,YAAY,CAAC;IACrC,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,gBAAgB,CAAC;IAC5C,OAAO,KAAK,CAAC,CAAC,0BAA0B,CACtC,KAAK,CAAC,IAAI,EACV,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1D,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACvB,IAAI,iBAAiB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAC3D,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,CAAC,WAAW,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7C,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAW,CAAC;IACjE,CAAC,CAAC,CACH,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,mEAAmE;AACnE,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,EAAE,CAAC,6BAA6B,CAAC,CAC/D,QAAQ,CAAC,EAAE,KAIV;IACC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,YAAY,CAAC;IACrC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;IAChE,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IACtD,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IAC1D,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;SAC7B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SAC5C,GAAG,CAAC,CAAC,QAAQ,EAA0B,EAAE,CAAC,CAAC;QAC1C,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,SAAS,EAAE,QAAQ,CAAC,IAAI,IAAI,MAAM,CAAC,SAAS;QAC5C,gBAAgB,EAAE,CAAC,QAAQ,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACnE,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,MAAM,CAAC,MAAM;YACpB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACpC,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,KAAK;gBAC7B,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC;gBACpC,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,WAAW,EAAE,KAAK,CAAC,WAAW;aAC/B,CAAC,CAAC;SACJ,CAAC,CAAC;QACH,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,IAAI;KACrB,CAAC,CAAC,CAAC;AACR,CAAC,CACF,CAAC;AAEF,+DAA+D;AAC/D,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,EAAE,CAAC,iCAAiC,CAAC,CACvE,QAAQ,CAAC,EAAE,KAIV;IACC,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,KAAK,KAAK,CAAC,QAAQ,CAAC,CAAC;IACxE,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACvB,IAAI,iBAAiB,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAChE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,KAAK,SAAS;QAC/B,CAAC,CAAC,QAAQ,CAAC,gBAAgB;QAC3B,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC,MAAM,CAC9B,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,CACxC,CAAC;AACR,CAAC,CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,EAAE,CAAC,6BAA6B,CAAC,CAAC,QAAQ,CAAC,EACzE,KAAqB;IAErB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC;IAC/B,KAAK,CAAC,CAAC,MAAM,CAAC;QACZ,IAAI,EAAE,4BAA4B;QAClC,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,YAAY,CAAC;IACrC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1D,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACvB,IAAI,qBAAqB,CAAC;YACxB,KAAK,EAAE,UAAU;YACjB,OAAO,EAAE,kBAAkB,KAAK,CAAC,QAAQ,sBAAsB;SAChE,CAAC,CACH,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC;IACrD,IACE,CAAC,KAAK,CAAC,MAAM,KAAK,KAAK,IAAI,SAAS,CAAC;QACrC,CAAC,KAAK,CAAC,MAAM,KAAK,aAAa,IAAI,CAAC,SAAS,CAAC,EAC9C,CAAC;QACD,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACvB,IAAI,qBAAqB,CAAC;YACxB,KAAK,EAAE,UAAU;YACjB,OAAO,EAAE,aAAa,KAAK,CAAC,QAAQ,QAAQ,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,aAAa;SACvF,CAAC,CACH,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GACV,KAAK,CAAC,MAAM,KAAK,SAAS;QAC1B,KAAK,CAAC,MAAM,KAAK,SAAS;QAC1B,QAAQ,CAAC,aAAa,KAAK,SAAS;QAClC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE;YAC3C,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,MAAM,EAAE,MAAM,CAAC,WAAW,CACxB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;gBACjD,GAAG;gBACH,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC;aACtB,CAAC,CACH;SACF,CAAC;QACJ,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,SAAS,CACvB,KAAK,CAAC,OAAO,EACb,SAAS;YACP,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ;iBACZ,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAE,CAAC;iBAC9D,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAChD,CAAC,CAAC,SAAS,CACd,CAAC;IACR,KAAK,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACzE,KAAK,CAAC,CAAC,MAAM,CAAC;QACZ,IAAI,EAAE,8BAA8B;QACpC,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,CAAC,GAAG,CAAC;QAChB,IAAI,EAAE,KAAK,CAAC,OAAO;QACnB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,6DAA6D;AAC7D,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,EAAE,CAAC,kCAAkC,CAAC,CACzE,QAAQ,CAAC,EACP,KAGC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,YAAY,CAAC;IACrC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACvB,IAAI,iBAAiB,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAChE,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1D,IAAI,MAAM,GACR,aAAa,CAAC;IAChB,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,QAAQ;aAC5B,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC;aACnC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACvB,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,IAAI,KAAK,CAAC,MAAM,IAAI,IAAI;gBACtB,KAAK,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;YACvD,MAAM,GAAG,WAAW,CAAC;QACvB,CAAC;;YAAM,MAAM,GAAG,wBAAwB,CAAC;IAC3C,CAAC;IACD,KAAK,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACpE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;AACtE,CAAC,CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC,2BAA2B,CAAC,CAAC,QAAQ,CAAC,EACrE,KAEC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC;IAC/B,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,YAAY,CAAC;IACrC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,SAAS,GACb,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;QAC3D,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE;QACtC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC;IACtB,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,MAAM,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YACnD,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACvB,IAAI,qBAAqB,CAAC;gBACxB,KAAK,EAAE,WAAW;gBAClB,OAAO,EAAE,aAAa,IAAI,mCAAmC;aAC9D,CAAC,CACH,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,0BAA0B,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,KAAK,CACrC,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,EACnD,CAAC,OAAO,EAAE,EAAE,CACV,QAAQ,CAAC,iBAAiB,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,CAC3D,MAAM,CAAC,QAAQ,CACb,CAAC,KAAK,EAAE,EAAE,CACR,IAAI,SAAS,CAAC;YACZ,OAAO,EAAE,+BAA+B,IAAI,6BAA6B,KAAK,CAAC,OAAO,IAAI;YAC1F,KAAK;SACN,CAAC,CACL,CACF,CACJ,CAAC;QACF,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,KAAK,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QACpE,CAAC;QACD,KAAK,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,4BAA4B,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,KAAK,CAAC,CAAC,GAAG,CAAC;QAChB,IAAI,EAAE,KAAK,CAAC,OAAO;QACnB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/lib/Alchemist/routes/provider.d.ts

@@ -0,0 +1,33 @@
+import * as Effect from "effect/Effect";
+import { AlchemistInvalidInput } from "../Errors.ts";
+import { type Target } from "../Session.ts";
+export interface CheckEnvironmentInput extends Target {
+    /** Providers to check. Omitted means every registered provider. */
+    readonly providers?: ReadonlyArray<string>;
+}
+export interface EnvironmentCheck {
+    readonly provider: string;
+    readonly status: "satisfied" | "missing" | "no-contract";
+    readonly missing: ReadonlyArray<{
+        readonly alternatives: ReadonlyArray<string>;
+    }>;
+}
+export interface EnvironmentCheckResult {
+    readonly checks: ReadonlyArray<EnvironmentCheck>;
+    readonly satisfied: boolean;
+}
+/**
+ * Verify the environment variables each registered provider's CI contract
+ * requires are present.
+ */
+export declare const checkEnvironment: (input: CheckEnvironmentInput) => Effect.Effect<{
+    checks: {
+        provider: string;
+        status: "missing" | "no-contract" | "satisfied";
+        missing: {
+            alternatives: ReadonlyArray<string>;
+        }[];
+    }[];
+    satisfied: boolean;
+}, AlchemistInvalidInput | import("../../Auth/AuthProvider.ts").AuthError | import("effect/PlatformError").PlatformError | import("../../Auth/Profile.ts").ProfileError, import("../../AlchemyContext.ts").AlchemyContext | import("effect/unstable/process/ChildProcessSpawner").ChildProcessSpawner | import("../../Auth/Credentials.ts").CredentialsStore | import("effect/Crypto").Crypto | import("effect/FileSystem").FileSystem | import("effect/unstable/http/HttpClient").HttpClient | import("effect/Path").Path | import("../../Auth/Profile.ts").ProfileStore | import("effect/Scope").Scope>;
+//# sourceMappingURL=provider.d.ts.map

package/lib/Alchemist/routes/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/Alchemist/routes/provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAMxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAGL,KAAK,MAAM,EACZ,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,qBAAsB,SAAQ,MAAM;IACnD,mEAAmE;IACnE,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,aAAa,CAAC;IACzD,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;QAC9B,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;KAC9C,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IACjD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAWD;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;0BA+Bc,aAAa,CAAC,MAAM,CAAC;;;;ykBA8B9D,CAAC"}

package/lib/Alchemist/routes/provider.js

@@ -0,0 +1,65 @@
+import * as ConfigProvider from "effect/ConfigProvider";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { getEnv } from "../../Auth/Env.js";
+import { resolveProfileName } from "../../Auth/Resolve.js";
+import { loadConfigProvider } from "../../Util/ConfigProvider.js";
+import { AlchemistInvalidInput } from "../Errors.js";
+import { collectAuthProviders, DEFAULT_ENTRYPOINT, } from "../Session.js";
+const satisfied = (variable) => Effect.gen(function* () {
+    for (const name of [variable.name, ...(variable.alternatives ?? [])]) {
+        const value = yield* getEnv(name);
+        if (value !== undefined && value.length > 0)
+            return true;
+    }
+    return false;
+});
+/**
+ * Verify the environment variables each registered provider's CI contract
+ * requires are present.
+ */
+export const checkEnvironment = Effect.fn("Alchemist.provider.checkEnvironment")(function* (input) {
+    const profile = yield* resolveProfileName(Option.fromNullishOr(input.envFile), input.profile);
+    const registry = yield* collectAuthProviders({
+        main: input.entrypoint ?? DEFAULT_ENTRYPOINT,
+        envFile: Option.fromNullishOr(input.envFile),
+        profile,
+    });
+    const known = Object.keys(registry).sort();
+    const names = yield* input.providers?.length
+        ? Effect.forEach(input.providers, (requested) => {
+            const name = known.find((candidate) => candidate.toLowerCase() === requested.toLowerCase());
+            return name === undefined
+                ? Effect.fail(new AlchemistInvalidInput({
+                    field: "providers",
+                    message: `Unknown provider '${requested}'. Registered: ${known.join(", ")}.`,
+                }))
+                : Effect.succeed(name);
+        })
+        : Effect.succeed(known);
+    const checks = yield* Effect.forEach(names, (name) => Effect.gen(function* () {
+        const contract = registry[name].environment;
+        const missing = [];
+        for (const variable of contract) {
+            if (variable.required && !(yield* satisfied(variable))) {
+                missing.push({
+                    alternatives: [variable.name, ...(variable.alternatives ?? [])],
+                });
+            }
+        }
+        return {
+            provider: name,
+            status: contract.length === 0
+                ? "no-contract"
+                : missing.length === 0
+                    ? "satisfied"
+                    : "missing",
+            missing,
+        };
+    })).pipe(Effect.provide(ConfigProvider.layer(yield* loadConfigProvider(Option.fromNullishOr(input.envFile)))));
+    return {
+        checks,
+        satisfied: checks.every((check) => check.status !== "missing"),
+    };
+});
+//# sourceMappingURL=provider.js.map

package/lib/Alchemist/routes/provider.js.map

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

package/lib/Alchemist/routes/stack.d.ts

@@ -0,0 +1,78 @@
+import * as Effect from "effect/Effect";
+import * as Plan from "../../Plan.ts";
+import type { PlannedAction, PlannedResource } from "../../Report.ts";
+import { type Session, type StackTarget } from "../Session.ts";
+export type { StackTarget } from "../Session.ts";
+export interface PlanInput {
+    readonly target: StackTarget;
+    readonly operation: "deploy" | "destroy";
+    readonly force?: boolean;
+    readonly adopt?: boolean;
+    readonly updateStateStore?: boolean;
+    /** Run local (emulated) providers instead of the real cloud. */
+    readonly dev?: boolean;
+}
+/** Infer the deployed stack output from an `alchemy.run.ts` module type. */
+export type StackModuleOutput<Module> = Module extends {
+    readonly default: infer Definition;
+} ? Definition extends Effect.Effect<any, any, any> ? Effect.Success<Definition> extends {
+    readonly output: infer Output;
+} ? Output : unknown : unknown : unknown;
+export interface PlanSummary {
+    readonly create: number;
+    readonly update: number;
+    readonly adopted: number;
+    readonly replace: number;
+    readonly delete: number;
+    readonly orphaned: number;
+    readonly noop: number;
+}
+export interface PlanSnapshot<Output = unknown> {
+    readonly stack: {
+        readonly name: string;
+        readonly stage: string;
+    };
+    readonly summary: PlanSummary;
+    /**
+     * Serializable resource rows (including orphan deletions) with their
+     * bindings and provider modes — what a remote renderer shows without
+     * holding {@link PlanSnapshot.native}.
+     */
+    readonly resources: ReadonlyArray<PlannedResource>;
+    /** Serializable stack-action rows. */
+    readonly actions: ReadonlyArray<PlannedAction>;
+    /** The engine plan, as consumed by in-process renderers and {@link apply}. */
+    readonly native: Plan.Plan<Output>;
+    readonly createdAt: Date;
+    /** The session this plan was computed under; {@link apply} runs in it. */
+    readonly session: Session;
+}
+/** Whether a plan proposes any cloud mutations (i.e. approval-worthy work). */
+export declare const hasChanges: (summary: PlanSummary) => boolean;
+export declare const summarize: (plan: Plan.Plan) => PlanSummary;
+/**
+ * Import the stack, resolve its services, and compute a deploy or destroy
+ * plan. Planning phases are reported through {@link Progress}; the returned
+ * snapshot is what {@link apply} executes.
+ */
+export declare const plan: <Module = unknown>(input: PlanInput) => Effect.Effect<{
+    resources: ReadonlyArray<PlannedResource>;
+    actions: ReadonlyArray<PlannedAction>;
+    stack: {
+        name: string;
+        stage: string;
+    };
+    summary: PlanSummary;
+    native: Plan.Plan<StackModuleOutput<Module>>;
+    createdAt: Date;
+    session: {
+        stack: import("../../Stack.ts").CompiledStack<unknown, unknown>;
+        context: import("effect/Context").Context<unknown>;
+    };
+}, unknown, import("../../AlchemyContext.ts").AlchemyContext | import("effect/unstable/process/ChildProcessSpawner").ChildProcessSpawner | import("../../Auth/Credentials.ts").CredentialsStore | import("effect/Crypto").Crypto | import("effect/FileSystem").FileSystem | import("effect/unstable/http/HttpClient").HttpClient | import("../../Interaction.ts").Interaction | import("effect/Path").Path | import("../../Auth/Profile.ts").ProfileStore | import("effect/Scope").Scope>;
+/**
+ * Apply a computed plan. Engine apply events are reported through
+ * {@link Progress} as `ApplyEvent`.
+ */
+export declare const apply: <Output>(snapshot: PlanSnapshot<Output>) => Effect.Effect<import("../../Input.ts").Input.Resolve<Output>, import("../../Auth/AuthProvider.ts").AuthError | import("effect/Config").ConfigError | import("../../Auth/Demand.ts").CredentialsRequired | import("../../Apply.ts").DestroyError | import("../../Output.ts").InvalidReferenceError | import("../../Output.ts").MissingSourceError | import("../../Auth/AuthProvider.ts").NeedsReauth | import("effect/PlatformError").PlatformError | import("../../State/State.ts").StateStoreError, never>;
+//# sourceMappingURL=stack.d.ts.map

package/lib/Alchemist/routes/stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack.d.ts","sourceRoot":"","sources":["../../../src/Alchemist/routes/stack.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,IAAI,MAAM,eAAe,CAAC;AACtC,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEtE,OAAO,EAAQ,KAAK,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAErE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,QAAQ,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,gEAAgE;IAChE,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,4EAA4E;AAC5E,MAAM,MAAM,iBAAiB,CAAC,MAAM,IAAI,MAAM,SAAS;IACrD,QAAQ,CAAC,OAAO,EAAE,MAAM,UAAU,CAAC;CACpC,GACG,UAAU,SAAS,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAC7C,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,CAAA;CAAE,GAClE,MAAM,GACN,OAAO,GACT,OAAO,GACT,OAAO,CAAC;AAEZ,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,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY,CAAC,MAAM,GAAG,OAAO;IAC5C,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;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IACnD,sCAAsC;IACtC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IAC/C,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,+EAA+E;AAC/E,eAAO,MAAM,UAAU,YAAa,WAAW,KAAG,OAO/C,CAAC;AAEJ,eAAO,MAAM,SAAS,SAAU,IAAI,CAAC,IAAI,KAAG,WAe3C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,IAAI,GACf,MAAM;;;;QAuBK,IAAI;QAAsB,KAAK;;;;;;;;;ydAO1C,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,KAAK,GAAiD,MAAM,ghBAQvE,CAAC"}

package/lib/Alchemist/routes/stack.js

@@ -0,0 +1,67 @@
+import * as Clock from "effect/Clock";
+import * as Effect from "effect/Effect";
+import { apply as applyPlan } from "../../Apply.js";
+import * as Plan from "../../Plan.js";
+import { applySession, Progress, withSpanEvents } from "../Progress.js";
+import { open } from "../Session.js";
+/** Whether a plan proposes any cloud mutations (i.e. approval-worthy work). */
+export const hasChanges = (summary) => summary.create +
+    summary.update +
+    summary.adopted +
+    summary.replace +
+    summary.delete +
+    summary.orphaned >
+    0;
+export const summarize = (plan) => {
+    const summary = {
+        create: 0,
+        update: 0,
+        adopted: 0,
+        replace: 0,
+        delete: 0,
+        orphaned: 0,
+        noop: 0,
+    };
+    for (const node of Object.values(plan.resources))
+        summary[node.action]++;
+    for (const node of Object.values(plan.deletions)) {
+        if (node !== undefined)
+            summary[node.action]++;
+    }
+    return summary;
+};
+/**
+ * Import the stack, resolve its services, and compute a deploy or destroy
+ * plan. Planning phases are reported through {@link Progress}; the returned
+ * snapshot is what {@link apply} executes.
+ */
+export const plan = Effect.fn("Alchemist.stack.plan")(function* (input) {
+    const report = withSpanEvents(yield* Progress);
+    // Everything below emits into the same flat ProgressEvent channel:
+    // `open` reports importing-module / resolving-services at the real work
+    // boundaries, the engine reports loading-state / computing-plan and the
+    // per-node diff events. Re-providing the wrapped reporter is all the
+    // route does — no translation layer.
+    const session = yield* open(input.target, input).pipe(Effect.provideService(Progress, report));
+    const native = (yield* (input.operation === "destroy"
+        ? Plan.destroy(session.stack)
+        : Plan.make(session.stack, { force: input.force })).pipe(Effect.provideService(Progress, report), Effect.provide(session.context)));
+    yield* report({ _tag: "plan.phase", phase: "plan-ready" });
+    return {
+        stack: { name: session.stack.name, stage: session.stack.stage },
+        summary: summarize(native),
+        ...Plan.describePlan(native),
+        native,
+        createdAt: new Date(yield* Clock.currentTimeMillis),
+        session,
+    };
+});
+/**
+ * Apply a computed plan. Engine apply events are reported through
+ * {@link Progress} as `ApplyEvent`.
+ */
+export const apply = Effect.fn("Alchemist.stack.apply")(function* (snapshot) {
+    const report = withSpanEvents(yield* Progress);
+    return yield* Effect.provide(applyPlan(snapshot.native, { session: applySession(report) }), snapshot.session.context);
+});
+//# sourceMappingURL=stack.js.map

package/lib/Alchemist/routes/stack.js.map

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

package/lib/Alchemist/routes/state.d.ts

@@ -0,0 +1,35 @@
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as State from "../../State/index.ts";
+import { type Target } from "../Session.ts";
+/** Which store a state request addresses. */
+export type StateSource = 
+/** `.alchemy/` on this machine, ignoring whatever the project configures. */
+{
+    readonly backend: "local";
+}
+/** A provider's default state store, without loading a project entrypoint. */
+ | ({
+    readonly backend: "aws" | "cloudflare";
+} & Pick<Target, "profile" | "envFile">)
+/** Whatever the project's entrypoint configures. */
+ | ({
+    readonly backend: "configured";
+} & Target);
+/**
+ * Resolve the state service a source addresses. The tree operations
+ * (`State.listState`, `State.readState`, `State.deleteState`) take `State`
+ * from context — provide the resolved service (or {@link layer}) to run
+ * them against the chosen store:
+ *
+ * ```ts
+ * const state = yield* Alchemist.State.store({ backend: "local" });
+ * const items = yield* State.listState({ path }).pipe(
+ *   Effect.provideService(State.State, Effect.succeed(state)),
+ * );
+ * ```
+ */
+export declare const store: (source: StateSource) => Effect.Effect<State.StateService, unknown, import("../../AlchemyContext.ts").AlchemyContext | import("../../Artifacts.ts").ArtifactStore | import("effect/unstable/process/ChildProcessSpawner").ChildProcessSpawner | import("../../Auth/Credentials.ts").CredentialsStore | import("effect/Crypto").Crypto | import("effect/FileSystem").FileSystem | import("effect/unstable/http/HttpClient").HttpClient | import("../../Interaction.ts").Interaction | import("effect/Path").Path | import("../../Auth/Profile.ts").ProfileStore | import("effect/Scope").Scope>;
+/** The chosen store as a `State` layer. */
+export declare const layer: (source: StateSource) => Layer.Layer<State.State, unknown, import("../../AlchemyContext.ts").AlchemyContext | import("../../Artifacts.ts").ArtifactStore | import("effect/unstable/process/ChildProcessSpawner").ChildProcessSpawner | import("../../Auth/Credentials.ts").CredentialsStore | import("effect/Crypto").Crypto | import("effect/FileSystem").FileSystem | import("effect/unstable/http/HttpClient").HttpClient | import("../../Interaction.ts").Interaction | import("effect/Path").Path | import("../../Auth/Profile.ts").ProfileStore>;
+//# sourceMappingURL=state.d.ts.map

package/lib/Alchemist/routes/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/Alchemist/routes/state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAMtC,OAAO,KAAK,KAAK,MAAM,sBAAsB,CAAC;AAE9C,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAElD,6CAA6C;AAC7C,MAAM,MAAM,WAAW;AACrB,6EAA6E;AAC3E;IAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE;AAC/B,8EAA8E;GAC5E,CAAC;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,GAAG,YAAY,CAAA;CAAE,GAAG,IAAI,CAChD,MAAM,EACN,SAAS,GAAG,SAAS,CACtB,CAAC;AACJ,oDAAoD;GAClD,CAAC;IAAE,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;CAAE,GAAG,MAAM,CAAC,CAAC;AAElD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,KAAK,gkBAmChB,CAAC;AAEH,2CAA2C;AAC3C,eAAO,MAAM,KAAK,WAAY,WAAW,kgBAC6B,CAAC"}

package/lib/Alchemist/routes/state.js

@@ -0,0 +1,42 @@
+import * as ConfigProvider from "effect/ConfigProvider";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import { AuthProviders } from "../../Auth/AuthProvider.js";
+import { withProfileOverride } from "../../Auth/Resolve.js";
+import * as AwsState from "../../AWS/StateStore/State.js";
+import * as CloudflareState from "../../Cloudflare/StateStore/State.js";
+import * as State from "../../State/index.js";
+import { loadConfigProvider } from "../../Util/ConfigProvider.js";
+import { open } from "../Session.js";
+/**
+ * Resolve the state service a source addresses. The tree operations
+ * (`State.listState`, `State.readState`, `State.deleteState`) take `State`
+ * from context — provide the resolved service (or {@link layer}) to run
+ * them against the chosen store:
+ *
+ * ```ts
+ * const state = yield* Alchemist.State.store({ backend: "local" });
+ * const items = yield* State.listState({ path }).pipe(
+ *   Effect.provideService(State.State, Effect.succeed(state)),
+ * );
+ * ```
+ */
+export const store = Effect.fn("Alchemist.state.store")(function* (source) {
+    if (source.backend === "local") {
+        return yield* Effect.provide(Effect.flatten(State.State), State.localState());
+    }
+    if (source.backend === "aws" || source.backend === "cloudflare") {
+        const config = ConfigProvider.layer(withProfileOverride(yield* loadConfigProvider(Option.fromNullishOr(source.envFile)), source.profile));
+        const authProviders = Layer.succeed(AuthProviders, {});
+        if (source.backend === "aws") {
+            return yield* Effect.flatten(State.State).pipe(Effect.provide(AwsState.state()), Effect.provide(authProviders), Effect.provide(config));
+        }
+        return yield* Effect.flatten(State.State).pipe(Effect.provide(CloudflareState.state()), Effect.provide(authProviders), Effect.provide(config));
+    }
+    const session = yield* open(source);
+    return yield* Effect.provide(Effect.flatten(State.State), session.context);
+});
+/** The chosen store as a `State` layer. */
+export const layer = (source) => Layer.effect(State.State, Effect.map(store(source), Effect.succeed));
+//# sourceMappingURL=state.js.map

package/lib/Alchemist/routes/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/Alchemist/routes/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,cAAc,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,QAAQ,MAAM,+BAA+B,CAAC;AAC1D,OAAO,KAAK,eAAe,MAAM,sCAAsC,CAAC;AACxE,OAAO,KAAK,KAAK,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,IAAI,EAAe,MAAM,eAAe,CAAC;AAclD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,uBAAuB,CAAC,CAAC,QAAQ,CAAC,EAC/D,MAAmB;IAEnB,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAC1B,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAC3B,KAAK,CAAC,UAAU,EAAE,CACnB,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK,IAAI,MAAM,CAAC,OAAO,KAAK,YAAY,EAAE,CAAC;QAChE,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CACjC,mBAAmB,CACjB,KAAK,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAC/D,MAAM,CAAC,OAAO,CACf,CACF,CAAC;QACF,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CACjC,aAAa,EACb,EAAqC,CACtC,CAAC;QACF,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;YAC7B,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAC5C,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,EAChC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAC7B,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CACvB,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAC5C,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC,EACvC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAC7B,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CACvB,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;AAC7E,CAAC,CAAC,CAAC;AAEH,2CAA2C;AAC3C,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,MAAmB,EAAE,EAAE,CAC3C,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC"}