alchemy 2.0.0-beta.test-export-fix-4 → 2.0.0-cli-bundle-fix.1

package/lib/State/HttpStateStore.js

@@ -0,0 +1,102 @@
+import * as Effect from "effect/Effect";
+import * as Schedule from "effect/Schedule";
+import * as HttpClient from "effect/unstable/http/HttpClient";
+import * as HttpClientRequest from "effect/unstable/http/HttpClientRequest";
+import * as HttpApiClient from "effect/unstable/httpapi/HttpApiClient";
+import { StateApi } from "./HttpStateApi.js";
+import { StateStoreError } from "./State.js";
+import { encodeState, reviveStateRecursive } from "./StateEncoding.js";
+export const makeHttpStateStore = ({ url, authToken }) => Effect.gen(function* () {
+    const apiClient = yield* HttpApiClient.make(StateApi, {
+        baseUrl: url,
+        transformClient: HttpClient.mapRequest(HttpClientRequest.bearerToken(authToken)),
+    });
+    const state = apiClient.state;
+    const service = {
+        listStacks: () => state.listStacks().pipe(Effect.map((stacks) => [...stacks]), mapStateStoreError),
+        listStages: (stack) => state.listStages({ params: { stack } }).pipe(mapStateStoreError),
+        list: (request) => state.listResources({ params: request }).pipe(mapStateStoreError),
+        get: (request) => state
+            .getState({
+            params: {
+                stack: request.stack,
+                stage: request.stage,
+                fqn: encodeURIComponent(request.fqn),
+            },
+        })
+            .pipe(Effect.map((s) => s == null
+            ? undefined
+            : reviveStateRecursive(s)), mapStateStoreError),
+        getReplacedResources: (request) => state.getReplacedResources({ params: request }).pipe(Effect.map((resources) => resources.map((s) => reviveStateRecursive(s))), mapStateStoreError),
+        set: (request) => state
+            .setState({
+            params: {
+                stack: request.stack,
+                stage: request.stage,
+                fqn: encodeURIComponent(request.fqn),
+            },
+            payload: encodeState(request.value),
+        })
+            .pipe(
+        // Server echoes the stored value, but the client already
+        // has the canonical object (including any Redacted<T>
+        // instances); returning the input avoids a lossy round-trip.
+        Effect.map(() => request.value), mapStateStoreError),
+        delete: (request) => state
+            .deleteState({
+            params: {
+                stack: request.stack,
+                stage: request.stage,
+                fqn: encodeURIComponent(request.fqn),
+            },
+        })
+            .pipe(Effect.asVoid, mapStateStoreError),
+        deleteStack: (request) => state
+            .deleteStack({
+            params: { stack: request.stack },
+            query: request.stage === undefined ? {} : { stage: request.stage },
+        })
+            .pipe(Effect.asVoid, mapStateStoreError),
+    };
+    return service;
+});
+/**
+ * Predicate over an `HttpClientError`-shaped failure that returns `true`
+ * for failures we expect to clear up on their own.
+ *
+ * We retry:
+ * - all transport-level errors (no `response` — DNS, TCP reset, TLS,
+ *   abort, etc.)
+ * - 408 (request timeout) and 429 (rate limit)
+ * - 404, which is normal in the seconds after a worker is first
+ *   deployed and the route hasn't propagated yet
+ * - every 5xx
+ *
+ * Anything else (400/401/403/etc.) is a real client-side problem and
+ * shouldn't be hidden behind retries.
+ */
+const isTransient = (e) => {
+    if (e?._tag !== "HttpClientError")
+        return false;
+    const status = e.response?.status;
+    if (status == null)
+        return true;
+    if (status === 404 || status === 408 || status === 429)
+        return true;
+    return status >= 500 && status < 600;
+};
+const retryTransient = (eff) => Effect.retry(eff, {
+    while: isTransient,
+    // Exponential backoff capped at 2s, no attempt limit. The state
+    // store is on the deploy critical path; we'd rather block than
+    // surface a transient blip as a hard failure (which historically
+    // stranded `syncState` mid-flight, leaving the remote store
+    // partially populated).
+    schedule: Schedule.exponential(100).pipe(Schedule.either(Schedule.spaced("2 seconds"))),
+});
+/** Collapse any client failure into a {@link StateStoreError}. */
+const mapStateStoreError = (eff) => eff.pipe(retryTransient, Effect.catch((e) => Effect.fail(new StateStoreError({
+    message: e instanceof Error ? e.message : String(e),
+    cause: e instanceof Error ? e : undefined,
+}))));
+//# sourceMappingURL=HttpStateStore.js.map

package/lib/State/HttpStateStore.js.map

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

package/lib/State/InMemoryState.d.ts

@@ -0,0 +1,10 @@
+import * as Layer from "effect/Layer";
+import type { ResourceState } from "./ResourceState.ts";
+import { State } from "./State.ts";
+type StackId = string;
+type StageId = string;
+type Fqn = string;
+export declare const inMemoryState: (initialState?: Record<StackId, Record<StageId, Record<Fqn, ResourceState>>>) => Layer.Layer<State, never, never>;
+export declare const InMemoryService: (state?: Record<StackId, Record<StageId, Record<Fqn, ResourceState>>>) => import("./State.ts").StateService;
+export {};
+//# sourceMappingURL=InMemoryState.d.ts.map

package/lib/State/InMemoryState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryState.d.ts","sourceRoot":"","sources":["../../src/State/InMemoryState.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,KAAK,OAAO,GAAG,MAAM,CAAC;AACtB,KAAK,OAAO,GAAG,MAAM,CAAC;AACtB,KAAK,GAAG,GAAG,MAAM,CAAC;AAElB,eAAO,MAAM,aAAa,GACxB,eAAc,MAAM,CAClB,OAAO,EACP,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CACvC,qCACgD,CAAC;AAEzD,eAAO,MAAM,eAAe,GAC1B,QAAO,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAM,sCAkEtE,CAAC"}

package/lib/State/InMemoryState.js

@@ -0,0 +1,27 @@
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { State } from "./State.js";
+export const inMemoryState = (initialState = {}) => Layer.succeed(State, InMemoryService(initialState));
+export const InMemoryService = (state = {}) => State.of({
+    listStacks: () => Effect.succeed(Array.from(Object.keys(state))),
+    listStages: (stack) => Effect.succeed(Array.from(stack in state ? Object.keys(state[stack]) : [])),
+    get: ({ stack, stage, fqn, }) => Effect.succeed(state[stack]?.[stage]?.[fqn]),
+    getReplacedResources: ({ stack, stage, }) => Effect.succeed(Array.from(Object.values(state[stack]?.[stage] ?? {}) ?? []).filter((s) => s.status === "replaced")),
+    set: ({ stack, stage, fqn, value, }) => {
+        const stackState = (state[stack] ??= {});
+        const stageState = (stackState[stage] ??= {});
+        stageState[fqn] = value;
+        return Effect.succeed(value);
+    },
+    delete: ({ stack, stage, fqn, }) => Effect.succeed(delete state[stack]?.[stage]?.[fqn]),
+    deleteStack: ({ stack, stage }) => Effect.sync(() => {
+        if (stage === undefined) {
+            delete state[stack];
+        }
+        else {
+            delete state[stack]?.[stage];
+        }
+    }),
+    list: ({ stack, stage }) => Effect.succeed(Array.from(Object.keys(state[stack]?.[stage] ?? {}) ?? [])),
+});
+//# sourceMappingURL=InMemoryState.js.map

package/lib/State/InMemoryState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryState.js","sourceRoot":"","sources":["../../src/State/InMemoryState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAMnC,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,eAGI,EAAE,EACN,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC;AAEzD,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,QAAsE,EAAE,EACxE,EAAE,CACF,KAAK,CAAC,EAAE,CAAC;IACP,UAAU,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAChE,UAAU,EAAE,CAAC,KAAa,EAAE,EAAE,CAC5B,MAAM,CAAC,OAAO,CACZ,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAC5D;IACH,GAAG,EAAE,CAAC,EACJ,KAAK,EACL,KAAK,EACL,GAAG,GAKJ,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAClD,oBAAoB,EAAE,CAAC,EACrB,KAAK,EACL,KAAK,GAIN,EAAE,EAAE,CACH,MAAM,CAAC,OAAO,CACZ,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CACjE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAC/B,CACF;IACH,GAAG,EAAE,CAA0B,EAC7B,KAAK,EACL,KAAK,EACL,GAAG,EACH,KAAK,GAMN,EAAE,EAAE;QACH,MAAM,UAAU,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QACzC,MAAM,UAAU,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAC9C,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACxB,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,MAAM,EAAE,CAAC,EACP,KAAK,EACL,KAAK,EACL,GAAG,GAKJ,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACzD,WAAW,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAqC,EAAE,EAAE,CACnE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QACf,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,OAAO,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC,CAAC;IACJ,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAoC,EAAE,EAAE,CAC3D,MAAM,CAAC,OAAO,CACZ,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,CAC3D;CACJ,CAAC,CAAC"}

package/lib/State/LocalState.d.ts

@@ -0,0 +1,8 @@
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Layer from "effect/Layer";
+import * as Path from "effect/Path";
+import { State, type StateService } from "./State.ts";
+export declare const localState: () => Layer.Layer<State, never, Path.Path | FileSystem.FileSystem>;
+export declare const makeLocalState: () => Effect.Effect<StateService, never, Path.Path | FileSystem.FileSystem>;
+//# sourceMappingURL=LocalState.d.ts.map

package/lib/State/LocalState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalState.d.ts","sourceRoot":"","sources":["../../src/State/LocalState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAGpC,OAAO,EAAE,KAAK,EAAmB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAGvE,eAAO,MAAM,UAAU,oEAA8C,CAAC;AAEtE,eAAO,MAAM,cAAc,6EAuGvB,CAAC"}

package/lib/State/LocalState.js

@@ -0,0 +1,50 @@
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Layer from "effect/Layer";
+import * as Path from "effect/Path";
+import { decodeFqn, encodeFqn } from "../FQN.js";
+import { State, StateStoreError } from "./State.js";
+import { encodeState, reviveState } from "./StateEncoding.js";
+export const localState = () => Layer.effect(State, makeLocalState());
+export const makeLocalState = () => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const dotAlchemy = path.join(process.cwd(), ".alchemy");
+    const stateDir = path.join(dotAlchemy, "state");
+    const fail = (err) => Effect.fail(new StateStoreError({
+        message: err.message,
+        cause: err,
+    }));
+    const recover = (effect) => effect.pipe(Effect.catchTag("PlatformError", (e) => e.reason._tag === "NotFound" ? Effect.void : fail(e)));
+    const stageDir = ({ stack, stage }) => path.join(stateDir, stack, stage);
+    const resource = ({ stack, stage, fqn, }) => path.join(stateDir, stack, stage, `${encodeFqn(fqn)}.json`);
+    const created = new Set();
+    const ensure = (dir) => created.has(dir)
+        ? Effect.succeed(void 0)
+        : fs
+            .makeDirectory(dir, { recursive: true })
+            .pipe(Effect.tap(() => Effect.sync(() => created.add(dir))));
+    const state = {
+        listStacks: () => fs.readDirectory(stateDir).pipe(recover, Effect.map((files) => files ?? [])),
+        listStages: (stack) => fs.readDirectory(path.join(stateDir, stack)).pipe(recover, Effect.map((files) => files ?? [])),
+        get: (request) => fs.readFile(resource(request)).pipe(Effect.map((file) => JSON.parse(file.toString(), reviveState)), recover),
+        getReplacedResources: Effect.fnUntraced(function* (request) {
+            return (yield* Effect.all((yield* state.list(request)).map((fqn) => state.get({
+                stack: request.stack,
+                stage: request.stage,
+                fqn,
+            })))).filter((r) => r?.status === "replaced");
+        }),
+        set: (request) => ensure(stageDir(request)).pipe(Effect.flatMap(() => fs.writeFileString(resource(request), JSON.stringify(encodeState(request.value), null, 2))), recover, Effect.map(() => request.value)),
+        delete: (request) => fs.remove(resource(request)).pipe(recover),
+        deleteStack: ({ stack, stage }) => fs
+            .remove(stage === undefined
+            ? path.join(stateDir, stack)
+            : stageDir({ stack, stage }), { recursive: true })
+            .pipe(recover),
+        list: (request) => fs.readDirectory(stageDir(request)).pipe(recover, Effect.map((files) => files?.map((file) => decodeFqn(file.replace(/\.json$/, ""))) ??
+            [])),
+    };
+    return state;
+});
+//# sourceMappingURL=LocalState.js.map

package/lib/State/LocalState.js.map

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

package/lib/State/ResourceState.d.ts

@@ -0,0 +1,94 @@
+import type { NamespaceNode } from "../Namespace.ts";
+import type { RemovalPolicy } from "../RemovalPolicy.ts";
+import type { ResourceBinding } from "../Resource.ts";
+export type ResourceState = CreatingResourceState | CreatedResourceState | UpdatingReourceState | UpdatedResourceState | DeletingResourceState | ReplacingResourceState | ReplacedResourceState;
+export type Props = Record<string, any>;
+export type Attr = Record<string, any>;
+export type ResourceStatus = ResourceState["status"];
+export type ReplacementResourceState = ReplacingResourceState | ReplacedResourceState;
+export type ReplacementOldResourceState = CreatingResourceState | CreatedResourceState | UpdatingReourceState | UpdatedResourceState | DeletingResourceState | ReplacementResourceState;
+interface BaseResourceState {
+    /** Type of the Resource (e.g. AWS.Lambda.Function) */
+    resourceType: string;
+    /** Namespace of the Resource */
+    namespace: NamespaceNode | undefined;
+    /** Fully Qualified Name (namespace path + logical ID) */
+    fqn: string;
+    /** Logical ID of the Resource (stable across creates, updates, deletes and replaces) */
+    logicalId: string;
+    /** A unique randomly generated token used to seed ID generation (only changes when replaced) */
+    instanceId: string;
+    /** The version of the provider that was used to create/update the resource. */
+    providerVersion: number;
+    /** Current status of the logical Resource */
+    status: ResourceStatus;
+    /** List of FQNs of resources that depend on this resource */
+    downstream: string[];
+    /** List of Bindings attached to this Resource */
+    bindings: ResourceBinding[];
+    /** Desired state (input props) of this Resource */
+    props?: Props;
+    /** The output attributes of this Resource (if it has been created) */
+    attr?: Attr;
+    /** The removal policy of the resource */
+    removalPolicy?: RemovalPolicy["Service"];
+}
+export interface CreatingResourceState extends BaseResourceState {
+    status: "creating";
+    /** The new resource properties that are being (or have been) applied. */
+    props: Props;
+}
+export interface CreatedResourceState extends BaseResourceState {
+    status: "created";
+    /** The new resource properties that have been applied. */
+    props: Props;
+    /** The output attributes of the created resource */
+    attr: Attr;
+}
+export interface UpdatingReourceState extends BaseResourceState {
+    status: "updating";
+    /** The new resource properties that are being (or have been) applied. */
+    props: Props;
+    old: {
+        /** The old resource properties that have been successfully applied. */
+        props: Props;
+        /** List of Bindings attached to this Resource */
+        bindings: any[];
+        /** The old output properties that have been successfully applied. */
+        attr: Attr;
+    };
+}
+export interface UpdatedResourceState extends BaseResourceState {
+    status: "updated";
+    /** The new resource properties that are being (or have been) applied. */
+    props: Props;
+    /** The output attributes of the created resource */
+    attr: Attr;
+}
+export interface DeletingResourceState extends BaseResourceState {
+    status: "deleting";
+    /** Attributes of the resource being deleted */
+    attr: Attr | undefined;
+}
+export interface ReplacingResourceState extends BaseResourceState {
+    status: "replacing";
+    /** Desired properties of the new resource (the replacement) */
+    props: Props;
+    /** Reference to the state of the old resource (the one being replaced) */
+    old: ReplacementOldResourceState;
+    /** Whether the resource should be deleted before or after replacements */
+    deleteFirst: boolean;
+}
+export interface ReplacedResourceState extends BaseResourceState {
+    status: "replaced";
+    /** Desired properties of the new resource (the replacement) */
+    props: Props;
+    /** Output attributes of the new resource (the replacement) */
+    attr: Attr;
+    /** Reference to the state of the old resource (the one being replaced) */
+    old: ReplacementOldResourceState;
+    /** Whether the resource should be deleted before or after replacements */
+    deleteFirst: boolean;
+}
+export {};
+//# sourceMappingURL=ResourceState.d.ts.map

package/lib/State/ResourceState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceState.d.ts","sourceRoot":"","sources":["../../src/State/ResourceState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,MAAM,MAAM,aAAa,GACrB,qBAAqB,GACrB,oBAAoB,GACpB,oBAAoB,GACpB,oBAAoB,GACpB,qBAAqB,GACrB,sBAAsB,GACtB,qBAAqB,CAAC;AAE1B,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACxC,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAEvC,MAAM,MAAM,cAAc,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;AACrD,MAAM,MAAM,wBAAwB,GAChC,sBAAsB,GACtB,qBAAqB,CAAC;AAC1B,MAAM,MAAM,2BAA2B,GACnC,qBAAqB,GACrB,oBAAoB,GACpB,oBAAoB,GACpB,oBAAoB,GACpB,qBAAqB,GACrB,wBAAwB,CAAC;AAE7B,UAAU,iBAAiB;IACzB,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,SAAS,EAAE,aAAa,GAAG,SAAS,CAAC;IACrC,yDAAyD;IACzD,GAAG,EAAE,MAAM,CAAC;IACZ,wFAAwF;IACxF,SAAS,EAAE,MAAM,CAAC;IAClB,gGAAgG;IAChG,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,eAAe,EAAE,MAAM,CAAC;IACxB,6CAA6C;IAC7C,MAAM,EAAE,cAAc,CAAC;IACvB,6DAA6D;IAC7D,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,iDAAiD;IACjD,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,mDAAmD;IACnD,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,sEAAsE;IACtE,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,yCAAyC;IACzC,aAAa,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D,MAAM,EAAE,UAAU,CAAC;IACnB,yEAAyE;IACzE,KAAK,EAAE,KAAK,CAAC;CACd;AAED,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,MAAM,EAAE,SAAS,CAAC;IAClB,0DAA0D;IAC1D,KAAK,EAAE,KAAK,CAAC;IACb,oDAAoD;IACpD,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,MAAM,EAAE,UAAU,CAAC;IACnB,yEAAyE;IACzE,KAAK,EAAE,KAAK,CAAC;IACb,GAAG,EAAE;QACH,uEAAuE;QACvE,KAAK,EAAE,KAAK,CAAC;QACb,iDAAiD;QACjD,QAAQ,EAAE,GAAG,EAAE,CAAC;QAChB,qEAAqE;QACrE,IAAI,EAAE,IAAI,CAAC;KAGZ,CAAC;CACH;AAED,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,MAAM,EAAE,SAAS,CAAC;IAClB,yEAAyE;IACzE,KAAK,EAAE,KAAK,CAAC;IACb,oDAAoD;IACpD,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D,MAAM,EAAE,UAAU,CAAC;IACnB,+CAA+C;IAC/C,IAAI,EAAE,IAAI,GAAG,SAAS,CAAC;CACxB;AAED,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D,MAAM,EAAE,WAAW,CAAC;IACpB,+DAA+D;IAC/D,KAAK,EAAE,KAAK,CAAC;IACb,0EAA0E;IAC1E,GAAG,EAAE,2BAA2B,CAAC;IACjC,0EAA0E;IAC1E,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D,MAAM,EAAE,UAAU,CAAC;IACnB,+DAA+D;IAC/D,KAAK,EAAE,KAAK,CAAC;IACb,8DAA8D;IAC9D,IAAI,EAAE,IAAI,CAAC;IACX,0EAA0E;IAC1E,GAAG,EAAE,2BAA2B,CAAC;IACjC,0EAA0E;IAC1E,WAAW,EAAE,OAAO,CAAC;CAEtB"}

package/lib/State/ResourceState.js

@@ -0,0 +1 @@
+//# sourceMappingURL=ResourceState.js.map

package/lib/State/ResourceState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceState.js","sourceRoot":"","sources":["../../src/State/ResourceState.ts"],"names":[],"mappings":""}

package/lib/State/State.d.ts

@@ -0,0 +1,77 @@
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import type { ReplacedResourceState, ResourceState } from "./ResourceState.ts";
+declare const StateStoreError_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: "StateStoreError";
+} & Readonly<A>;
+export declare class StateStoreError extends StateStoreError_base<{
+    message: string;
+    cause?: Error;
+}> {
+}
+declare const State_base: Context.ServiceClass<State, "alchemy/State", StateService>;
+export declare class State extends State_base {
+}
+/**
+ * State service interface.
+ *
+ * Resources are keyed by FQN (namespace-qualified key) which includes
+ * the full namespace path plus the logical ID. The FQN is used as the
+ * storage key while logicalId remains available in the persisted state
+ * for provider operations.
+ */
+export interface StateService {
+    listStacks(): Effect.Effect<readonly string[], StateStoreError, never>;
+    listStages(stack: string): Effect.Effect<readonly string[], StateStoreError, never>;
+    /**
+     * Get a resource by its FQN (namespace-qualified key).
+     */
+    get(request: {
+        stack: string;
+        stage: string;
+        fqn: string;
+    }): Effect.Effect<ResourceState | undefined, StateStoreError, never>;
+    /**
+     * List top-level resources that are still in replacement cleanup.
+     *
+     * Any additional backlog from repeated replacements is stored recursively
+     * in the returned state's `old` chain.
+     */
+    getReplacedResources(request: {
+        stack: string;
+        stage: string;
+    }): Effect.Effect<ReadonlyArray<ReplacedResourceState>, StateStoreError, never>;
+    /**
+     * Set a resource by its FQN (namespace-qualified key).
+     */
+    set<V extends ResourceState>(request: {
+        stack: string;
+        stage: string;
+        fqn: string;
+        value: V;
+    }): Effect.Effect<V, StateStoreError, never>;
+    /**
+     * Delete a resource by its FQN (namespace-qualified key).
+     */
+    delete(request: {
+        stack: string;
+        stage: string;
+        fqn: string;
+    }): Effect.Effect<void, StateStoreError, never>;
+    /**
+     * Delete an entire stack, or a single stage when `stage` is provided.
+     */
+    deleteStack(request: {
+        stack: string;
+        stage?: string;
+    }): Effect.Effect<void, StateStoreError, never>;
+    /**
+     * List all resource FQNs in a stack/stage.
+     */
+    list(request: {
+        stack: string;
+        stage: string;
+    }): Effect.Effect<readonly string[], StateStoreError, never>;
+}
+export {};
+//# sourceMappingURL=State.d.ts.map

package/lib/State/State.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"State.d.ts","sourceRoot":"","sources":["../../src/State/State.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAE1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;;;;AAE/E,qBAAa,eAAgB,SAAQ,qBAAoC;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,CAAC;CAAG;;AAEL,qBAAa,KAAM,SAAQ,UAE1B;CAAG;AAEJ;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,MAAM,EAAE,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;IACvE,UAAU,CACR,KAAK,EAAE,MAAM,GACZ,MAAM,CAAC,MAAM,CAAC,SAAS,MAAM,EAAE,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;IAC5D;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;KACb,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,GAAG,SAAS,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;IACrE;;;;;OAKG;IACH,oBAAoB,CAAC,OAAO,EAAE;QAC5B,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;KACf,GAAG,MAAM,CAAC,MAAM,CACf,aAAa,CAAC,qBAAqB,CAAC,EACpC,eAAe,EACf,KAAK,CACN,CAAC;IACF;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,aAAa,EAAE,OAAO,EAAE;QACpC,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,CAAC,CAAC;KACV,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;IAC7C;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE;QACd,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;KACb,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;IAChD;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;IAChD;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;KACf,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,MAAM,EAAE,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;CAC9D"}

package/lib/State/State.js

@@ -0,0 +1,8 @@
+import * as Context from "effect/Context";
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+export class StateStoreError extends Data.TaggedError("StateStoreError") {
+}
+export class State extends Context.Service()("alchemy/State") {
+}
+//# sourceMappingURL=State.js.map

package/lib/State/State.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"State.js","sourceRoot":"","sources":["../../src/State/State.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,MAAM,OAAO,eAAgB,SAAQ,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAGrE;CAAG;AAEL,MAAM,OAAO,KAAM,SAAQ,OAAO,CAAC,OAAO,EAAuB,CAC/D,eAAe,CAChB;CAAG"}

package/lib/State/StateEncoding.d.ts

@@ -0,0 +1,31 @@
+/**
+ * JSON marker used to tag a `Redacted<T>` value when writing state.
+ * The reviver recognises objects with exactly this key and rebuilds
+ * the `Redacted` wrapper on read.
+ */
+export declare const REDACTED_MARKER = "__redacted__";
+/**
+ * Recursively encode a state value for JSON serialisation.
+ *
+ * - `Redacted<T>` values are wrapped as `{ [REDACTED_MARKER]: <inner> }`
+ *   so the actual string is persisted rather than the `<redacted>`
+ *   placeholder produced by the default `toJSON`.
+ * - `Resource` instances are flattened to `{ id, type, props, attr }`
+ *   so persisted state matches the schema used by the loader.
+ * - Plain objects and arrays are walked structurally.
+ */
+export declare const encodeState: (value: unknown) => unknown;
+/**
+ * JSON reviver that rebuilds `Redacted<T>` values that were written
+ * through {@link encodeState}. Intended for use with `JSON.parse`.
+ */
+export declare const reviveState: (_key: string, value: unknown) => unknown;
+/**
+ * Recursively walk an already-decoded value and rebuild `Redacted<T>`
+ * instances from `{ [REDACTED_MARKER]: <inner> }` envelopes. Mirror
+ * image of {@link encodeState} for callers that hold a parsed JS
+ * value rather than a JSON string (e.g. the HTTP state-store client,
+ * which receives values pre-parsed by `HttpApiClient`).
+ */
+export declare const reviveStateRecursive: (value: unknown) => unknown;
+//# sourceMappingURL=StateEncoding.d.ts.map

package/lib/State/StateEncoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StateEncoding.d.ts","sourceRoot":"","sources":["../../src/State/StateEncoding.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,eAAe,iBAAiB,CAAC;AAE9C;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,OAwB5C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,EAAE,OAAO,OAAO,KAAG,OAU1D,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,OAAO,OAAO,KAAG,OAarD,CAAC"}

package/lib/State/StateEncoding.js

@@ -0,0 +1,82 @@
+import * as Redacted from "effect/Redacted";
+import { isResource } from "../Resource.js";
+/**
+ * JSON marker used to tag a `Redacted<T>` value when writing state.
+ * The reviver recognises objects with exactly this key and rebuilds
+ * the `Redacted` wrapper on read.
+ */
+export const REDACTED_MARKER = "__redacted__";
+/**
+ * Recursively encode a state value for JSON serialisation.
+ *
+ * - `Redacted<T>` values are wrapped as `{ [REDACTED_MARKER]: <inner> }`
+ *   so the actual string is persisted rather than the `<redacted>`
+ *   placeholder produced by the default `toJSON`.
+ * - `Resource` instances are flattened to `{ id, type, props, attr }`
+ *   so persisted state matches the schema used by the loader.
+ * - Plain objects and arrays are walked structurally.
+ */
+export const encodeState = (value) => {
+    if (value === null || value === undefined)
+        return value;
+    if (Redacted.isRedacted(value)) {
+        return {
+            [REDACTED_MARKER]: encodeState(Redacted.value(value)),
+        };
+    }
+    if (isResource(value)) {
+        return {
+            id: value.LogicalId,
+            type: value.Type,
+            props: encodeState(value.Props),
+            attr: encodeState(value.Attributes),
+        };
+    }
+    if (Array.isArray(value))
+        return value.map(encodeState);
+    if (typeof value === "object") {
+        const result = {};
+        for (const [k, v] of Object.entries(value)) {
+            result[k] = encodeState(v);
+        }
+        return result;
+    }
+    return value;
+};
+/**
+ * JSON reviver that rebuilds `Redacted<T>` values that were written
+ * through {@link encodeState}. Intended for use with `JSON.parse`.
+ */
+export const reviveState = (_key, value) => {
+    if (value !== null &&
+        typeof value === "object" &&
+        !Array.isArray(value) &&
+        REDACTED_MARKER in value) {
+        return Redacted.make(value[REDACTED_MARKER]);
+    }
+    return value;
+};
+/**
+ * Recursively walk an already-decoded value and rebuild `Redacted<T>`
+ * instances from `{ [REDACTED_MARKER]: <inner> }` envelopes. Mirror
+ * image of {@link encodeState} for callers that hold a parsed JS
+ * value rather than a JSON string (e.g. the HTTP state-store client,
+ * which receives values pre-parsed by `HttpApiClient`).
+ */
+export const reviveStateRecursive = (value) => {
+    if (value === null || typeof value !== "object")
+        return value;
+    if (Array.isArray(value))
+        return value.map(reviveStateRecursive);
+    const obj = value;
+    const keys = Object.keys(obj);
+    if (keys.length === 1 && keys[0] === REDACTED_MARKER) {
+        return Redacted.make(reviveStateRecursive(obj[REDACTED_MARKER]));
+    }
+    const result = {};
+    for (const [k, v] of Object.entries(obj)) {
+        result[k] = reviveStateRecursive(v);
+    }
+    return result;
+};
+//# sourceMappingURL=StateEncoding.js.map

package/lib/State/StateEncoding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StateEncoding.js","sourceRoot":"","sources":["../../src/State/StateEncoding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,cAAc,CAAC;AAE9C;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAc,EAAW,EAAE;IACrD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACxD,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO;YACL,CAAC,eAAe,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;SACtD,CAAC;IACJ,CAAC;IACD,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO;YACL,EAAE,EAAE,KAAK,CAAC,SAAS;YACnB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC;YAC/B,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC;SACpC,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACxD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3C,MAAM,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,KAAc,EAAW,EAAE;IACnE,IACE,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrB,eAAe,IAAI,KAAK,EACxB,CAAC;QACD,OAAO,QAAQ,CAAC,IAAI,CAAE,KAAiC,CAAC,eAAe,CAAC,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAc,EAAW,EAAE;IAC9D,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACjE,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,eAAe,EAAE,CAAC;QACrD,OAAO,QAAQ,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,CAAC,CAAC,CAAC,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/lib/State/Sync.d.ts

@@ -0,0 +1,23 @@
+import * as Effect from "effect/Effect";
+import { type StateService } from "./State.ts";
+/**
+ * Synchronize all state (every stack/stage/resource) from `source` into
+ * `destination` so that `destination` becomes a mirror of `source`.
+ *
+ * For each `{ stack, stage, fqn }` present in `source`, the resource is
+ * written into `destination`, overwriting any existing entry under the same
+ * key. Any keys present in `destination` but absent from `source` are
+ * deleted, ensuring the two stores end up structurally identical.
+ *
+ * Stacks are walked sequentially; stages within a stack and resources
+ * within a stage are processed concurrently for throughput.
+ */
+export declare const syncState: (source: StateService, destination: StateService, options?: {
+    stacks?: string[];
+    /**
+     * Maximum number of resources to copy in parallel within a single stage.
+     * @default "unbounded".
+     */
+    concurrency?: number | "unbounded";
+} | undefined) => Effect.Effect<void, import("./State.ts").StateStoreError, never>;
+//# sourceMappingURL=Sync.d.ts.map

package/lib/State/Sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sync.d.ts","sourceRoot":"","sources":["../../src/State/Sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,SAAS;aAIT,MAAM,EAAE;IACjB;;;OAGG;kBACW,MAAM,GAAG,WAAW;kFA4DpC,CAAC"}