@gaganref/confect-alchemy 0.0.0-stage → 10.3.1-fork.10

package/dist/Deployment.d.ts

@@ -0,0 +1,113 @@
+import type { CreateDeploymentType, RegionName } from "@convex-dev/platform/managementApi";
+import { OwnedBySomeoneElse } from "alchemy/AdoptPolicy";
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Schema from "effect/Schema";
+import { ConvexClient } from "./ConvexClient.js";
+import type { Providers } from "./Providers.js";
+export interface DeploymentProps {
+    readonly projectId: number;
+    readonly type: CreateDeploymentType;
+    readonly reference?: string;
+    readonly region?: RegionName;
+}
+export interface DeploymentAttributes {
+    readonly projectId: number;
+    readonly name: string;
+    readonly reference: string;
+    readonly type: CreateDeploymentType;
+    readonly url: string;
+    /**
+     * Always set in the cloud; a local deployment echoes the requested region.
+     */
+    readonly region?: RegionName;
+}
+export type Deployment = Resource<"Convex.Deployment", DeploymentProps, DeploymentAttributes, never, Providers>;
+export declare const Deployment: import("alchemy/Resource").ResourceClass<Deployment>;
+declare const DeploymentIdentityChange_base: Schema.Class<DeploymentIdentityChange, Schema.TaggedStruct<"DeploymentIdentityChange", {
+    readonly deploymentName: Schema.String;
+    readonly field: Schema.String;
+    readonly current: Schema.String;
+    readonly requested: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class DeploymentIdentityChange extends DeploymentIdentityChange_base {
+}
+declare const UnsupportedLocalDeployment_base: Schema.Class<UnsupportedLocalDeployment, Schema.TaggedStruct<"UnsupportedLocalDeployment", {
+    readonly deploymentName: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class UnsupportedLocalDeployment extends UnsupportedLocalDeployment_base {
+}
+declare const AmbiguousDeployment_base: Schema.Class<AmbiguousDeployment, Schema.TaggedStruct<"AmbiguousDeployment", {
+    readonly projectId: Schema.Finite;
+    readonly reference: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class AmbiguousDeployment extends AmbiguousDeployment_base {
+}
+export declare const provider: Effect.Effect<{
+    diff: (args_0: {
+        id: string;
+        fqn: string;
+        instanceId: string;
+        olds: DeploymentProps;
+        news: import("alchemy/Input").Input<DeploymentProps>;
+        oldBindings: import("alchemy/Resource").ResourceBinding<never>[];
+        newBindings: import("alchemy/Input").Input<import("alchemy/Resource").ResourceBinding<never>[]>;
+        output: DeploymentAttributes | undefined;
+    }) => Effect.Effect<{
+        action: "update";
+    } | undefined, import("./ConvexClient.js").ConvexApiError | import("./ConvexClient.js").ConvexConflict | DeploymentIdentityChange | UnsupportedLocalDeployment, never>;
+    read: (args_0: {
+        id: string;
+        fqn: string;
+        instanceId: string;
+        olds: DeploymentProps;
+        output: DeploymentAttributes | undefined;
+    }) => Effect.Effect<{
+        projectId: number;
+        name: string;
+        reference: string;
+        type: "custom" | "dev" | "preview" | "prod";
+        url: string;
+        region: "aws-ap-southeast-2" | "aws-ca-central-1" | "aws-eu-west-1" | "aws-us-east-1";
+    } | undefined, AmbiguousDeployment | import("./ConvexClient.js").ConvexApiError | import("./ConvexClient.js").ConvexConflict | import("./ConvexClient.js").ConvexNotFound | UnsupportedLocalDeployment, never>;
+    reconcile: (args_0: {
+        id: string;
+        fqn: string;
+        instanceId: string;
+        news: DeploymentProps;
+        olds: DeploymentProps | undefined;
+        output: DeploymentAttributes | undefined;
+        session: import("alchemy/Report").ScopedPlanStatusSession;
+        bindings: import("alchemy/Resource").ResourceBinding<never>[];
+    }) => Effect.Effect<{
+        projectId: number;
+        name: string;
+        reference: string;
+        type: "custom" | "dev" | "preview" | "prod";
+        url: string;
+        region: "aws-ap-southeast-2" | "aws-ca-central-1" | "aws-eu-west-1" | "aws-us-east-1";
+    }, AmbiguousDeployment | import("./ConvexClient.js").ConvexApiError | import("./ConvexClient.js").ConvexConflict | import("./ConvexClient.js").ConvexNotFound | DeploymentIdentityChange | import("./internal/Lifecycle.js").LifecycleStateError | OwnedBySomeoneElse | import("alchemy/State/State").StateStoreError | UnsupportedLocalDeployment, never>;
+    delete: (args_0: {
+        id: string;
+        fqn: string;
+        instanceId: string;
+        olds: DeploymentProps;
+        output: DeploymentAttributes;
+        session: import("alchemy/Report").ScopedPlanStatusSession;
+        bindings: import("alchemy/Resource").ResourceBinding<never>[];
+        force?: boolean;
+    }) => Effect.Effect<void, import("./ConvexClient.js").ConvexApiError | import("./ConvexClient.js").ConvexConflict, never>;
+}, never, ConvexClient>;
+/**
+ * Under `alchemy dev` a deployment is a local Convex backend this provider
+ * owns. Alchemy's dev sidecar hosts it, so the backend keeps running across
+ * reloads of the stack and stops when the dev session ends. Its data lives in
+ * `.alchemy/convex/<stack>/<stage>/<name>` and is removed only when the
+ * deployment is destroyed.
+ */
+export declare const localLayer: import("effect/Layer").Layer<Provider.Provider<Deployment>, never, import("alchemy/AlchemyContext").AlchemyContext | import("alchemy/Artifacts").ArtifactStore | import("effect/process/ChildProcessSpawner").ChildProcessSpawner | import("effect/Crypto").Crypto | FileSystem.FileSystem | import("effect/http/HttpClient").HttpClient | import("effect/Path").Path | import("alchemy/Stack").Stack>;
+export declare const layer: import("effect/Layer").Layer<Provider.Provider<Deployment>, never, ConvexClient>;
+export {};
+//# sourceMappingURL=Deployment.d.ts.map

package/dist/Deployment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Deployment.d.ts","sourceRoot":"","sources":["../src/Deployment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EAEpB,UAAU,EACX,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAW,MAAM,qBAAqB,CAAC;AAGlE,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAKhD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;CAC9B;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,CAC/B,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,KAAK,EACL,SAAS,CACV,CAAC;AACF,eAAO,MAAM,UAAU,sDAErB,CAAC;;;;;;;AAEH,qBAAa,wBAAyB,SAAQ,6BAQ7C;CAAG;;;;AAEJ,qBAAa,0BAA2B,SAAQ,+BAG/C;CAAG;;;;;AAEJ,qBAAa,mBAAoB,SAAQ,wBAGxC;CAAG;AAEJ,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAyInB,CAAC;AAOH;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,wYAoDtB,CAAC;AAEF,eAAO,MAAM,KAAK,kFAAwC,CAAC"}

package/dist/Deployment.js

@@ -0,0 +1,160 @@
+import { ConvexClient } from "./ConvexClient.js";
+import { checkpointCreate, shouldAdopt } from "./internal/Lifecycle.js";
+import { resourceName } from "./internal/ResourceIdentity.js";
+import { boot, dataDirectories, remove } from "./internal/LocalBackend.js";
+import * as Effect from "effect/Effect";
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import * as Schema from "effect/Schema";
+import * as FileSystem from "effect/FileSystem";
+import { OwnedBySomeoneElse, Unowned } from "alchemy/AdoptPolicy";
+import { isResolved } from "alchemy/Diff";
+import * as LocalProvider from "alchemy/Local/LocalProvider";
+import { moduleExtension } from "alchemy/Util/Node";
+//#region src/Deployment.ts
+const Deployment = Resource("Convex.Deployment", { defaultRemovalPolicy: "retain" });
+var DeploymentIdentityChange = class extends Schema.TaggedError()("DeploymentIdentityChange", {
+	deploymentName: Schema.String,
+	field: Schema.String,
+	current: Schema.String,
+	requested: Schema.String
+}) {};
+var UnsupportedLocalDeployment = class extends Schema.TaggedError()("UnsupportedLocalDeployment", { deploymentName: Schema.String }) {};
+var AmbiguousDeployment = class extends Schema.TaggedError()("AmbiguousDeployment", {
+	projectId: Schema.Finite,
+	reference: Schema.String
+}) {};
+const provider = Effect.gen(function* () {
+	const client = yield* ConvexClient;
+	const attributes = Effect.fn("Deployment.attributes")(function* (deployment) {
+		if (deployment.kind !== "cloud") return yield* new UnsupportedLocalDeployment({ deploymentName: deployment.name });
+		return {
+			projectId: deployment.projectId,
+			name: deployment.name,
+			reference: deployment.reference,
+			type: deployment.deploymentType,
+			url: deployment.deploymentUrl,
+			region: deployment.region
+		};
+	});
+	const find = Effect.fn("Deployment.find")(function* (projectId, reference) {
+		const matches = (yield* client.listDeployments(projectId)).filter((deployment) => deployment.kind === "cloud" && deployment.reference === reference);
+		if (matches.length > 1) return yield* new AmbiguousDeployment({
+			projectId,
+			reference
+		});
+		return matches[0];
+	});
+	const validate = Effect.fn("Deployment.validate")(function* (current, news) {
+		for (const field of [
+			"projectId",
+			"type",
+			"region"
+		]) if (news[field] !== void 0 && current[field] !== news[field]) return yield* new DeploymentIdentityChange({
+			deploymentName: current.name,
+			field,
+			current: String(current[field]),
+			requested: String(news[field])
+		});
+	});
+	return {
+		diff: Effect.fn("Deployment.diff")(function* ({ news, output }) {
+			if (!isResolved(news) || !output) return;
+			yield* validate(output, news);
+			const deployment = yield* client.getDeployment(output.name).pipe(Effect.catchTag("ConvexNotFound", () => Effect.void));
+			if (!deployment) return { action: "update" };
+			const current = yield* attributes(deployment);
+			yield* validate(current, news);
+			if ((news.reference ?? output.reference) !== current.reference) return { action: "update" };
+		}),
+		read: Effect.fn("Deployment.read")(function* ({ fqn, instanceId, olds, output }) {
+			if (output) {
+				const deployment = yield* client.getDeployment(output.name).pipe(Effect.catchTag("ConvexNotFound", () => Effect.void));
+				return deployment ? yield* attributes(deployment) : void 0;
+			}
+			if (olds.projectId === void 0) return;
+			const deployment = yield* find(olds.projectId, olds.reference ?? (yield* resourceName("deployment", fqn, instanceId)));
+			return deployment ? Unowned(yield* attributes(deployment)) : void 0;
+		}),
+		reconcile: Effect.fn("Deployment.reconcile")(function* ({ fqn, instanceId, news, output }) {
+			if (!output) yield* checkpointCreate(fqn, instanceId, news);
+			if (output) yield* validate(output, news);
+			let deployment = output ? yield* client.getDeployment(output.name).pipe(Effect.catchTag("ConvexNotFound", () => Effect.void)) : void 0;
+			const reference = news.reference ?? output?.reference ?? (yield* resourceName("deployment", fqn, instanceId));
+			if (!deployment) {
+				const existing = yield* find(news.projectId, reference);
+				if (existing && !(yield* shouldAdopt(fqn))) return yield* new OwnedBySomeoneElse({
+					message: "An existing deployment requires explicit adoption.",
+					resourceType: Deployment.Type,
+					physicalName: reference
+				});
+				if (existing) {
+					const adopted = yield* attributes(existing);
+					yield* validate(adopted, news);
+					yield* checkpointCreate(fqn, instanceId, news, adopted);
+					deployment = existing;
+				} else deployment = yield* client.createDeployment(news.projectId, {
+					type: news.type,
+					reference,
+					...news.region === void 0 ? {} : { region: news.region }
+				});
+			}
+			const current = yield* attributes(deployment);
+			yield* validate(current, news);
+			if (current.reference !== reference) {
+				const existing = yield* find(news.projectId, reference);
+				if (existing && existing.name !== current.name) return yield* new OwnedBySomeoneElse({
+					message: "The requested deployment reference is already in use.",
+					resourceType: Deployment.Type,
+					physicalName: reference
+				});
+				yield* client.updateDeployment(current.name, { reference });
+				deployment = yield* client.getDeployment(current.name);
+			}
+			return yield* attributes(deployment);
+		}),
+		delete: Effect.fn("Deployment.delete")(function* ({ output }) {
+			yield* client.deleteDeployment(output.name).pipe(Effect.catchTag("ConvexNotFound", () => Effect.void));
+		})
+	};
+});
+/**
+* Under `alchemy dev` a deployment is a local Convex backend this provider
+* owns. Alchemy's dev sidecar hosts it, so the backend keeps running across
+* reloads of the stack and stops when the dev session ends. Its data lives in
+* `.alchemy/convex/<stack>/<stage>/<name>` and is removed only when the
+* deployment is destroyed.
+*/
+const localLayer = LocalProvider.make(Deployment, new URL(`./internal/LocalSidecar${moduleExtension(import.meta.url)}`, import.meta.url).href, Effect.gen(function* () {
+	const fs = yield* FileSystem.FileSystem;
+	const directory = yield* dataDirectories;
+	return {
+		resolveConfig: Effect.fn("Deployment.localConfig")(function* ({ fqn, instanceId, news }) {
+			return {
+				name: yield* resourceName("deployment", fqn, instanceId),
+				props: news
+			};
+		}),
+		start: Effect.fn("Deployment.localStart")(function* ({ config, invalidate }) {
+			const backend = yield* boot(config.name, directory(config.name));
+			yield* backend.exited.pipe(Effect.andThen(invalidate), Effect.forkScoped);
+			return {
+				projectId: config.props.projectId,
+				name: config.name,
+				reference: config.props.reference ?? config.name,
+				type: config.props.type,
+				url: backend.url,
+				...config.props.region === void 0 ? {} : { region: config.props.region }
+			};
+		}),
+		stop: Effect.fn("Deployment.localStop")(function* ({ fqn, instanceId }) {
+			const name = yield* resourceName("deployment", fqn, instanceId);
+			yield* remove(name, directory(name)).pipe(Effect.provideService(FileSystem.FileSystem, fs));
+		})
+	};
+}));
+const layer = Provider.effect(Deployment, provider);
+//#endregion
+export { AmbiguousDeployment, Deployment, DeploymentIdentityChange, UnsupportedLocalDeployment, layer, localLayer, provider };
+
+//# sourceMappingURL=Deployment.js.map

package/dist/Deployment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Deployment.js","names":[],"sources":["../src/Deployment.ts"],"sourcesContent":["import type {\n  CreateDeploymentType,\n  PlatformDeploymentResponse,\n  RegionName,\n} from \"@convex-dev/platform/managementApi\";\nimport { OwnedBySomeoneElse, Unowned } from \"alchemy/AdoptPolicy\";\nimport { isResolved } from \"alchemy/Diff\";\nimport * as LocalProvider from \"alchemy/Local/LocalProvider\";\nimport * as Provider from \"alchemy/Provider\";\nimport { Resource } from \"alchemy/Resource\";\nimport { moduleExtension } from \"alchemy/Util/Node\";\nimport * as Effect from \"effect/Effect\";\nimport * as FileSystem from \"effect/FileSystem\";\nimport * as Schema from \"effect/Schema\";\n\nimport { ConvexClient } from \"./ConvexClient.js\";\nimport type { Providers } from \"./Providers.js\";\nimport { resourceName } from \"./internal/ResourceIdentity.js\";\nimport { checkpointCreate, shouldAdopt } from \"./internal/Lifecycle.js\";\nimport { boot, dataDirectories, remove } from \"./internal/LocalBackend.js\";\n\nexport interface DeploymentProps {\n  readonly projectId: number;\n  readonly type: CreateDeploymentType;\n  readonly reference?: string;\n  readonly region?: RegionName;\n}\n\nexport interface DeploymentAttributes {\n  readonly projectId: number;\n  readonly name: string;\n  readonly reference: string;\n  readonly type: CreateDeploymentType;\n  readonly url: string;\n  /**\n   * Always set in the cloud; a local deployment echoes the requested region.\n   */\n  readonly region?: RegionName;\n}\n\nexport type Deployment = Resource<\n  \"Convex.Deployment\",\n  DeploymentProps,\n  DeploymentAttributes,\n  never,\n  Providers\n>;\nexport const Deployment = Resource<Deployment>(\"Convex.Deployment\", {\n  defaultRemovalPolicy: \"retain\",\n});\n\nexport class DeploymentIdentityChange extends Schema.TaggedError<DeploymentIdentityChange>()(\n  \"DeploymentIdentityChange\",\n  {\n    deploymentName: Schema.String,\n    field: Schema.String,\n    current: Schema.String,\n    requested: Schema.String,\n  },\n) {}\n\nexport class UnsupportedLocalDeployment extends Schema.TaggedError<UnsupportedLocalDeployment>()(\n  \"UnsupportedLocalDeployment\",\n  { deploymentName: Schema.String },\n) {}\n\nexport class AmbiguousDeployment extends Schema.TaggedError<AmbiguousDeployment>()(\n  \"AmbiguousDeployment\",\n  { projectId: Schema.Finite, reference: Schema.String },\n) {}\n\nexport const provider = Effect.gen(function* () {\n  const client = yield* ConvexClient;\n  const attributes = Effect.fn(\"Deployment.attributes\")(function* (\n    deployment: PlatformDeploymentResponse,\n  ) {\n    if (deployment.kind !== \"cloud\")\n      return yield* new UnsupportedLocalDeployment({\n        deploymentName: deployment.name,\n      });\n    return {\n      projectId: deployment.projectId,\n      name: deployment.name,\n      reference: deployment.reference,\n      type: deployment.deploymentType,\n      url: deployment.deploymentUrl,\n      region: deployment.region,\n    } satisfies DeploymentAttributes;\n  });\n  const find = Effect.fn(\"Deployment.find\")(function* (\n    projectId: number,\n    reference: string,\n  ) {\n    const matches = (yield* client.listDeployments(projectId)).filter(\n      (deployment) =>\n        deployment.kind === \"cloud\" && deployment.reference === reference,\n    );\n    if (matches.length > 1)\n      return yield* new AmbiguousDeployment({ projectId, reference });\n    return matches[0];\n  });\n  const validate = Effect.fn(\"Deployment.validate\")(function* (\n    current: DeploymentAttributes,\n    news: DeploymentProps,\n  ) {\n    for (const field of [\"projectId\", \"type\", \"region\"] as const) {\n      if (news[field] !== undefined && current[field] !== news[field])\n        return yield* new DeploymentIdentityChange({\n          deploymentName: current.name,\n          field,\n          current: String(current[field]),\n          requested: String(news[field]),\n        });\n    }\n  });\n  return {\n    diff: Effect.fn(\"Deployment.diff\")(function* ({ news, output }) {\n      if (!isResolved(news) || !output) return;\n      yield* validate(output, news);\n      const deployment = yield* client\n        .getDeployment(output.name)\n        .pipe(Effect.catchTag(\"ConvexNotFound\", () => Effect.void));\n      if (!deployment) return { action: \"update\" };\n      const current = yield* attributes(deployment);\n      yield* validate(current, news);\n      if ((news.reference ?? output.reference) !== current.reference)\n        return { action: \"update\" };\n    }),\n    read: Effect.fn(\"Deployment.read\")(function* ({\n      fqn,\n      instanceId,\n      olds,\n      output,\n    }) {\n      if (output) {\n        const deployment = yield* client\n          .getDeployment(output.name)\n          .pipe(Effect.catchTag(\"ConvexNotFound\", () => Effect.void));\n        return deployment ? yield* attributes(deployment) : undefined;\n      }\n      if (olds.projectId === undefined) return;\n      const deployment = yield* find(\n        olds.projectId,\n        olds.reference ?? (yield* resourceName(\"deployment\", fqn, instanceId)),\n      );\n      return deployment ? Unowned(yield* attributes(deployment)) : undefined;\n    }),\n    reconcile: Effect.fn(\"Deployment.reconcile\")(function* ({\n      fqn,\n      instanceId,\n      news,\n      output,\n    }) {\n      if (!output) yield* checkpointCreate(fqn, instanceId, news);\n      if (output) yield* validate(output, news);\n      let deployment = output\n        ? yield* client\n            .getDeployment(output.name)\n            .pipe(Effect.catchTag(\"ConvexNotFound\", () => Effect.void))\n        : undefined;\n      const reference =\n        news.reference ??\n        output?.reference ??\n        (yield* resourceName(\"deployment\", fqn, instanceId));\n      if (!deployment) {\n        const existing = yield* find(news.projectId, reference);\n        if (existing && !(yield* shouldAdopt(fqn)))\n          return yield* new OwnedBySomeoneElse({\n            message: \"An existing deployment requires explicit adoption.\",\n            resourceType: Deployment.Type,\n            physicalName: reference,\n          });\n        if (existing) {\n          const adopted = yield* attributes(existing);\n          yield* validate(adopted, news);\n          yield* checkpointCreate(fqn, instanceId, news, adopted);\n          deployment = existing;\n        } else {\n          deployment = yield* client.createDeployment(news.projectId, {\n            type: news.type,\n            reference,\n            ...(news.region === undefined ? {} : { region: news.region }),\n          });\n        }\n      }\n      const current = yield* attributes(deployment);\n      yield* validate(current, news);\n      if (current.reference !== reference) {\n        const existing = yield* find(news.projectId, reference);\n        if (existing && existing.name !== current.name)\n          return yield* new OwnedBySomeoneElse({\n            message: \"The requested deployment reference is already in use.\",\n            resourceType: Deployment.Type,\n            physicalName: reference,\n          });\n        yield* client.updateDeployment(current.name, {\n          reference,\n        });\n        deployment = yield* client.getDeployment(current.name);\n      }\n      return yield* attributes(deployment);\n    }),\n    delete: Effect.fn(\"Deployment.delete\")(function* ({ output }) {\n      yield* client\n        .deleteDeployment(output.name)\n        .pipe(Effect.catchTag(\"ConvexNotFound\", () => Effect.void));\n    }),\n  } satisfies Provider.ProviderServiceInput<Deployment>;\n});\n\ninterface LocalConfig {\n  readonly name: string;\n  readonly props: DeploymentProps;\n}\n\n/**\n * Under `alchemy dev` a deployment is a local Convex backend this provider\n * owns. Alchemy's dev sidecar hosts it, so the backend keeps running across\n * reloads of the stack and stops when the dev session ends. Its data lives in\n * `.alchemy/convex/<stack>/<stage>/<name>` and is removed only when the\n * deployment is destroyed.\n */\nexport const localLayer = LocalProvider.make(\n  Deployment,\n  new URL(\n    `./internal/LocalSidecar${moduleExtension(import.meta.url)}`,\n    import.meta.url,\n  ).href,\n  Effect.gen(function* () {\n    const fs = yield* FileSystem.FileSystem;\n    const directory = yield* dataDirectories;\n    return {\n      resolveConfig: Effect.fn(\"Deployment.localConfig\")(function* ({\n        fqn,\n        instanceId,\n        news,\n      }) {\n        return {\n          name: yield* resourceName(\"deployment\", fqn, instanceId),\n          props: news,\n        } satisfies LocalConfig;\n      }),\n      start: Effect.fn(\"Deployment.localStart\")(function* ({\n        config,\n        invalidate,\n      }) {\n        const backend = yield* boot(config.name, directory(config.name));\n        yield* backend.exited.pipe(\n          Effect.andThen(invalidate),\n          Effect.forkScoped,\n        );\n        return {\n          projectId: config.props.projectId,\n          name: config.name,\n          reference: config.props.reference ?? config.name,\n          type: config.props.type,\n          url: backend.url,\n          ...(config.props.region === undefined\n            ? {}\n            : { region: config.props.region }),\n        } satisfies DeploymentAttributes;\n      }),\n      stop: Effect.fn(\"Deployment.localStop\")(function* ({ fqn, instanceId }) {\n        const name = yield* resourceName(\"deployment\", fqn, instanceId);\n        yield* remove(name, directory(name)).pipe(\n          Effect.provideService(FileSystem.FileSystem, fs),\n        );\n      }),\n    } satisfies LocalProvider.LocalProviderSpec<\n      Deployment,\n      LocalConfig,\n      Effect.Services<ReturnType<typeof boot>>\n    >;\n  }),\n);\n\nexport const layer = Provider.effect(Deployment, provider);\n"],"mappings":"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"}

package/dist/EnvironmentVariables.d.ts

@@ -0,0 +1,155 @@
+import { OwnedBySomeoneElse } from "alchemy/AdoptPolicy";
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Redacted from "effect/Redacted";
+import * as Schema from "effect/Schema";
+import * as ConvexClient from "./ConvexClient.js";
+import type { Providers } from "./Providers.js";
+export interface EnvironmentVariablesProps {
+    readonly url: string;
+    readonly deployKey: Redacted.Redacted<string>;
+    readonly variables: Readonly<Record<string, string | Redacted.Redacted<string>>>;
+}
+export interface EnvironmentVariablesAttributes {
+    readonly url: string;
+    readonly deployKey: Redacted.Redacted<string>;
+    readonly ownedNames: ReadonlyArray<string>;
+    readonly variables: Readonly<Record<string, Redacted.Redacted<string>>>;
+    readonly originals: Readonly<Record<string, Redacted.Redacted<string>>>;
+}
+export type EnvironmentVariables = Resource<"Convex.EnvironmentVariables", EnvironmentVariablesProps, EnvironmentVariablesAttributes, never, Providers>;
+export declare const EnvironmentVariables: import("alchemy/Resource").ResourceClass<EnvironmentVariables>;
+declare const EnvironmentTargetChange_base: Schema.Class<EnvironmentTargetChange, Schema.TaggedStruct<"EnvironmentTargetChange", {
+    readonly url: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class EnvironmentTargetChange extends EnvironmentTargetChange_base {
+}
+export declare const provider: Effect.Effect<{
+    diff: (args_0: {
+        id: string;
+        fqn: string;
+        instanceId: string;
+        olds: EnvironmentVariablesProps;
+        news: import("alchemy/Input").Input<EnvironmentVariablesProps>;
+        oldBindings: import("alchemy/Resource").ResourceBinding<never>[];
+        newBindings: import("alchemy/Input").Input<import("alchemy/Resource").ResourceBinding<never>[]>;
+        output: EnvironmentVariablesAttributes | undefined;
+    }) => Effect.Effect<{
+        action: "update";
+    } | undefined, EnvironmentTargetChange | ConvexClient.ConvexClientError, never>;
+    read: (args_0: {
+        id: string;
+        fqn: string;
+        instanceId: string;
+        olds: EnvironmentVariablesProps;
+        output: EnvironmentVariablesAttributes | undefined;
+    }) => Effect.Effect<{
+        url: string;
+        ownedNames: ReadonlyArray<string>;
+        originals: Readonly<Record<string, Redacted.Redacted<string>>>;
+        deployKey: Redacted.Redacted<string>;
+        variables: {
+            [k: string]: Redacted.Redacted<string>;
+        };
+    } | undefined, ConvexClient.ConvexClientError, never>;
+    reconcile: (args_0: {
+        id: string;
+        fqn: string;
+        instanceId: string;
+        news: EnvironmentVariablesProps;
+        olds: EnvironmentVariablesProps | undefined;
+        output: EnvironmentVariablesAttributes | undefined;
+        session: import("alchemy/Report").ScopedPlanStatusSession;
+        bindings: import("alchemy/Resource").ResourceBinding<never>[];
+    }) => Effect.Effect<{
+        url: string;
+        deployKey: Redacted.Redacted<string>;
+        ownedNames: string[];
+        variables: {
+            [k: string]: Redacted.Redacted<string>;
+        };
+        originals: {
+            [k: string]: Redacted.Redacted<string>;
+        };
+    }, ConvexClient.ConvexApiError | ConvexClient.ConvexConflict | ConvexClient.ConvexNotFound | EnvironmentTargetChange | import("./internal/Lifecycle.js").LifecycleStateError | OwnedBySomeoneElse | import("alchemy/State/State").StateStoreError, never>;
+    delete: (args_0: {
+        id: string;
+        fqn: string;
+        instanceId: string;
+        olds: EnvironmentVariablesProps;
+        output: EnvironmentVariablesAttributes;
+        session: import("alchemy/Report").ScopedPlanStatusSession;
+        bindings: import("alchemy/Resource").ResourceBinding<never>[];
+        force?: boolean;
+    }) => Effect.Effect<void, ConvexClient.ConvexApiError | ConvexClient.ConvexConflict, never>;
+}, never, ConvexClient.ConvexClient>;
+/**
+ * Under `alchemy dev` variables are managed on the local backend. A backend
+ * that is not running keeps its variables in its retained data, so removing
+ * them is skipped rather than failing the apply.
+ */
+export declare const localProvider: Effect.Effect<{
+    diff: (args_0: {
+        id: string;
+        fqn: string;
+        instanceId: string;
+        olds: EnvironmentVariablesProps;
+        news: import("alchemy/Input").Input<EnvironmentVariablesProps>;
+        oldBindings: import("alchemy/Resource").ResourceBinding<never>[];
+        newBindings: import("alchemy/Input").Input<import("alchemy/Resource").ResourceBinding<never>[]>;
+        output: EnvironmentVariablesAttributes | undefined;
+    }) => Effect.Effect<{
+        action: "update";
+    } | undefined, EnvironmentTargetChange | ConvexClient.ConvexClientError, never>;
+    read: (args_0: {
+        id: string;
+        fqn: string;
+        instanceId: string;
+        olds: EnvironmentVariablesProps;
+        output: EnvironmentVariablesAttributes | undefined;
+    }) => Effect.Effect<{
+        url: string;
+        ownedNames: ReadonlyArray<string>;
+        originals: Readonly<Record<string, Redacted.Redacted<string>>>;
+        deployKey: Redacted.Redacted<string>;
+        variables: {
+            [k: string]: Redacted.Redacted<string>;
+        };
+    } | undefined, ConvexClient.ConvexClientError, never>;
+    reconcile: (args_0: {
+        id: string;
+        fqn: string;
+        instanceId: string;
+        news: EnvironmentVariablesProps;
+        olds: EnvironmentVariablesProps | undefined;
+        output: EnvironmentVariablesAttributes | undefined;
+        session: import("alchemy/Report").ScopedPlanStatusSession;
+        bindings: import("alchemy/Resource").ResourceBinding<never>[];
+    }) => Effect.Effect<{
+        url: string;
+        deployKey: Redacted.Redacted<string>;
+        ownedNames: string[];
+        variables: {
+            [k: string]: Redacted.Redacted<string>;
+        };
+        originals: {
+            [k: string]: Redacted.Redacted<string>;
+        };
+    }, ConvexClient.ConvexApiError | ConvexClient.ConvexConflict | ConvexClient.ConvexNotFound | EnvironmentTargetChange | import("./internal/Lifecycle.js").LifecycleStateError | OwnedBySomeoneElse | import("alchemy/State/State").StateStoreError, never>;
+    delete: (input: {
+        id: string;
+        fqn: string;
+        instanceId: string;
+        olds: EnvironmentVariablesProps;
+        output: EnvironmentVariablesAttributes;
+        session: import("alchemy/Report").ScopedPlanStatusSession;
+        bindings: import("alchemy/Resource").ResourceBinding<never>[];
+        force?: boolean;
+    }) => Effect.Effect<void, any, never>;
+}, never, ConvexClient.ConvexClient>;
+export declare const layer: Layer.Layer<Provider.Provider<EnvironmentVariables>, never, ConvexClient.ConvexClient>;
+export declare const localLayer: Layer.Layer<Provider.Provider<EnvironmentVariables>, never, never>;
+export {};
+//# sourceMappingURL=EnvironmentVariables.d.ts.map

package/dist/EnvironmentVariables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvironmentVariables.d.ts","sourceRoot":"","sources":["../src/EnvironmentVariables.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAW,MAAM,qBAAqB,CAAC;AAElE,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAC1B,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CACnD,CAAC;CACH;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACxE,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;CACzE;AAED,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CACzC,6BAA6B,EAC7B,yBAAyB,EACzB,8BAA8B,EAC9B,KAAK,EACL,SAAS,CACV,CAAC;AACF,eAAO,MAAM,oBAAoB,gEAEhC,CAAC;;;;AAEF,qBAAa,uBAAwB,SAAQ,4BAG5C;CAAG;AAEJ,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;aAvBL,MAAM;oBAEC,aAAa,CAAC,MAAM,CAAC;mBAEtB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oCA+LvE,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;aA1MV,MAAM;oBAEC,aAAa,CAAC,MAAM,CAAC;mBAEtB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oCAsNxE,CAAC;AAEF,eAAO,MAAM,KAAK,wFAAkD,CAAC;AACrE,eAAO,MAAM,UAAU,oEAStB,CAAC"}

package/dist/EnvironmentVariables.js

@@ -0,0 +1,135 @@
+import { ConvexClient, layer as layer$1 } from "./ConvexClient.js";
+import { checkpointCreate, shouldAdopt } from "./internal/Lifecycle.js";
+import * as Effect from "effect/Effect";
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import * as Redacted from "effect/Redacted";
+import * as Schema from "effect/Schema";
+import * as Layer from "effect/Layer";
+import { OwnedBySomeoneElse, Unowned } from "alchemy/AdoptPolicy";
+import { isResolved } from "alchemy/Diff";
+import * as FetchHttpClient from "effect/http/FetchHttpClient";
+//#region src/EnvironmentVariables.ts
+const EnvironmentVariables = Resource("Convex.EnvironmentVariables");
+var EnvironmentTargetChange = class extends Schema.TaggedError()("EnvironmentTargetChange", { url: Schema.String }) {};
+const provider = Effect.gen(function* () {
+	const client = yield* ConvexClient;
+	const redacted = (value) => typeof value === "string" ? Redacted.make(value) : value;
+	const valueAt = (variables, name) => Object.hasOwn(variables, name) ? variables[name] : void 0;
+	const select = (variables, names) => Object.fromEntries(names.flatMap((name) => !Object.hasOwn(variables, name) ? [] : [[name, variables[name]]]));
+	return {
+		diff: Effect.fn("EnvironmentVariables.diff")(function* ({ news, output }) {
+			if (!isResolved(news) || !output) return;
+			if (news.url !== output.url) return yield* new EnvironmentTargetChange({ url: output.url });
+			const names = Object.keys(news.variables);
+			if (names.length !== output.ownedNames.length || names.some((name) => !output.ownedNames.includes(name))) return { action: "update" };
+			const variables = yield* client.listEnvironmentVariables(news.url, news.deployKey);
+			for (const [name, value] of Object.entries(news.variables)) {
+				const observed = valueAt(variables, name);
+				if (observed === void 0 || Redacted.value(observed) !== Redacted.value(redacted(value))) return { action: "update" };
+			}
+		}),
+		read: Effect.fn("EnvironmentVariables.read")(function* ({ olds, output }) {
+			const url = output?.url ?? olds.url;
+			if (url === void 0 || olds.deployKey === void 0) return;
+			const observed = yield* client.listEnvironmentVariables(url, olds.deployKey);
+			const ownedNames = output?.ownedNames ?? Object.keys(olds.variables);
+			const variables = select(observed, ownedNames);
+			if (output) return {
+				...output,
+				deployKey: olds.deployKey,
+				variables
+			};
+			if (Object.keys(variables).length === 0) return void 0;
+			return Unowned({
+				url,
+				deployKey: olds.deployKey,
+				ownedNames,
+				variables,
+				originals: variables
+			});
+		}),
+		reconcile: Effect.fn("EnvironmentVariables.reconcile")(function* ({ fqn, instanceId, news, output }) {
+			if (!output) yield* checkpointCreate(fqn, instanceId, news);
+			if (output && output.url !== news.url) return yield* new EnvironmentTargetChange({ url: output.url });
+			const observed = yield* client.listEnvironmentVariables(news.url, news.deployKey);
+			const ownedNames = Object.keys(news.variables);
+			if (!output && (yield* shouldAdopt(fqn))) {
+				const variables = select(observed, ownedNames);
+				output = {
+					url: news.url,
+					deployKey: news.deployKey,
+					ownedNames,
+					variables,
+					originals: variables
+				};
+				yield* checkpointCreate(fqn, instanceId, news, output);
+			}
+			const previousNames = output?.ownedNames ?? [];
+			for (const name of ownedNames) if (!previousNames.includes(name) && valueAt(observed, name) !== void 0) return yield* new OwnedBySomeoneElse({
+				message: "An existing environment variable requires explicit adoption in a separate resource.",
+				resourceType: EnvironmentVariables.Type,
+				physicalName: name
+			});
+			const desired = Object.fromEntries(Object.entries(news.variables).map(([name, value]) => [name, redacted(value)]));
+			const changes = [];
+			for (const [name, value] of Object.entries(desired)) {
+				const current = valueAt(observed, name);
+				if (current === void 0 || Redacted.value(current) !== Redacted.value(value)) changes.push({
+					name,
+					value
+				});
+			}
+			for (const name of previousNames) {
+				if (Object.hasOwn(desired, name)) continue;
+				const original = output ? valueAt(output.originals, name) : void 0;
+				const current = valueAt(observed, name);
+				if (original !== void 0) {
+					if (current === void 0 || Redacted.value(current) !== Redacted.value(original)) changes.push({
+						name,
+						value: original
+					});
+				} else if (current !== void 0) changes.push({ name });
+			}
+			if (changes.length > 0) yield* client.updateEnvironmentVariables(news.url, news.deployKey, changes);
+			return {
+				url: news.url,
+				deployKey: news.deployKey,
+				ownedNames,
+				variables: desired,
+				originals: select(output?.originals ?? {}, ownedNames)
+			};
+		}),
+		delete: Effect.fn("EnvironmentVariables.delete")(function* ({ output }) {
+			const observed = yield* client.listEnvironmentVariables(output.url, output.deployKey).pipe(Effect.catchTag("ConvexNotFound", () => Effect.void));
+			if (observed === void 0) return;
+			const changes = [];
+			for (const name of output.ownedNames) {
+				const original = valueAt(output.originals, name);
+				const current = valueAt(observed, name);
+				if (original !== void 0) {
+					if (current === void 0 || Redacted.value(current) !== Redacted.value(original)) changes.push({
+						name,
+						value: original
+					});
+				} else if (current !== void 0) changes.push({ name });
+			}
+			if (changes.length > 0) yield* client.updateEnvironmentVariables(output.url, output.deployKey, changes).pipe(Effect.catchTag("ConvexNotFound", () => Effect.void));
+		})
+	};
+});
+/**
+* Under `alchemy dev` variables are managed on the local backend. A backend
+* that is not running keeps its variables in its retained data, so removing
+* them is skipped rather than failing the apply.
+*/
+const localProvider = Effect.map(provider, (service) => ({
+	...service,
+	delete: (input) => service.delete(input).pipe(Effect.catchIf((error) => error._tag === "ConvexApiError" && error.code === "TransportError", () => Effect.void))
+}));
+const layer = Provider.effect(EnvironmentVariables, provider);
+const localLayer = Provider.effect(EnvironmentVariables, localProvider).pipe(Layer.provide(layer$1({ mode: "local" }).pipe(Layer.provide(FetchHttpClient.layer))));
+//#endregion
+export { EnvironmentTargetChange, EnvironmentVariables, layer, localLayer, localProvider, provider };
+
+//# sourceMappingURL=EnvironmentVariables.js.map

package/dist/EnvironmentVariables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvironmentVariables.js","names":["ConvexClient.ConvexClient","ConvexClient.layer"],"sources":["../src/EnvironmentVariables.ts"],"sourcesContent":["import { OwnedBySomeoneElse, Unowned } from \"alchemy/AdoptPolicy\";\nimport { isResolved } from \"alchemy/Diff\";\nimport * as Provider from \"alchemy/Provider\";\nimport { Resource } from \"alchemy/Resource\";\nimport * as Effect from \"effect/Effect\";\nimport * as Layer from \"effect/Layer\";\nimport * as FetchHttpClient from \"effect/http/FetchHttpClient\";\nimport * as Redacted from \"effect/Redacted\";\nimport * as Schema from \"effect/Schema\";\n\nimport * as ConvexClient from \"./ConvexClient.js\";\nimport type { Providers } from \"./Providers.js\";\nimport { checkpointCreate, shouldAdopt } from \"./internal/Lifecycle.js\";\n\nexport interface EnvironmentVariablesProps {\n  readonly url: string;\n  readonly deployKey: Redacted.Redacted<string>;\n  readonly variables: Readonly<\n    Record<string, string | Redacted.Redacted<string>>\n  >;\n}\n\nexport interface EnvironmentVariablesAttributes {\n  readonly url: string;\n  readonly deployKey: Redacted.Redacted<string>;\n  readonly ownedNames: ReadonlyArray<string>;\n  readonly variables: Readonly<Record<string, Redacted.Redacted<string>>>;\n  readonly originals: Readonly<Record<string, Redacted.Redacted<string>>>;\n}\n\nexport type EnvironmentVariables = Resource<\n  \"Convex.EnvironmentVariables\",\n  EnvironmentVariablesProps,\n  EnvironmentVariablesAttributes,\n  never,\n  Providers\n>;\nexport const EnvironmentVariables = Resource<EnvironmentVariables>(\n  \"Convex.EnvironmentVariables\",\n);\n\nexport class EnvironmentTargetChange extends Schema.TaggedError<EnvironmentTargetChange>()(\n  \"EnvironmentTargetChange\",\n  { url: Schema.String },\n) {}\n\nexport const provider = Effect.gen(function* () {\n  const client = yield* ConvexClient.ConvexClient;\n  const redacted = (value: string | Redacted.Redacted<string>) =>\n    typeof value === \"string\" ? Redacted.make(value) : value;\n  const valueAt = (\n    variables: Readonly<Record<string, Redacted.Redacted<string>>>,\n    name: string,\n  ) => (Object.hasOwn(variables, name) ? variables[name] : undefined);\n  const select = (\n    variables: Readonly<Record<string, Redacted.Redacted<string>>>,\n    names: ReadonlyArray<string>,\n  ) =>\n    Object.fromEntries(\n      names.flatMap((name) =>\n        !Object.hasOwn(variables, name) ? [] : [[name, variables[name]]],\n      ),\n    );\n  return {\n    diff: Effect.fn(\"EnvironmentVariables.diff\")(function* ({ news, output }) {\n      if (!isResolved(news) || !output) return;\n      if (news.url !== output.url)\n        return yield* new EnvironmentTargetChange({\n          url: output.url,\n        });\n      const names = Object.keys(news.variables);\n      if (\n        names.length !== output.ownedNames.length ||\n        names.some((name) => !output.ownedNames.includes(name))\n      )\n        return { action: \"update\" };\n      const variables = yield* client.listEnvironmentVariables(\n        news.url,\n        news.deployKey,\n      );\n      for (const [name, value] of Object.entries(news.variables)) {\n        const observed = valueAt(variables, name);\n        if (\n          observed === undefined ||\n          Redacted.value(observed) !== Redacted.value(redacted(value))\n        )\n          return { action: \"update\" };\n      }\n    }),\n    read: Effect.fn(\"EnvironmentVariables.read\")(function* ({ olds, output }) {\n      const url = output?.url ?? olds.url;\n      if (url === undefined || olds.deployKey === undefined) return;\n      const observed = yield* client.listEnvironmentVariables(\n        url,\n        olds.deployKey,\n      );\n      const ownedNames = output?.ownedNames ?? Object.keys(olds.variables);\n      const variables = select(observed, ownedNames);\n      if (output) return { ...output, deployKey: olds.deployKey, variables };\n      if (Object.keys(variables).length === 0) return undefined;\n      return Unowned({\n        url,\n        deployKey: olds.deployKey,\n        ownedNames,\n        variables,\n        originals: variables,\n      });\n    }),\n    reconcile: Effect.fn(\"EnvironmentVariables.reconcile\")(function* ({\n      fqn,\n      instanceId,\n      news,\n      output,\n    }) {\n      if (!output) yield* checkpointCreate(fqn, instanceId, news);\n      if (output && output.url !== news.url)\n        return yield* new EnvironmentTargetChange({\n          url: output.url,\n        });\n      const observed = yield* client.listEnvironmentVariables(\n        news.url,\n        news.deployKey,\n      );\n      const ownedNames = Object.keys(news.variables);\n      if (!output && (yield* shouldAdopt(fqn))) {\n        const variables = select(observed, ownedNames);\n        output = {\n          url: news.url,\n          deployKey: news.deployKey,\n          ownedNames,\n          variables,\n          originals: variables,\n        };\n        yield* checkpointCreate(fqn, instanceId, news, output);\n      }\n      const previousNames = output?.ownedNames ?? [];\n      for (const name of ownedNames) {\n        if (\n          !previousNames.includes(name) &&\n          valueAt(observed, name) !== undefined\n        )\n          return yield* new OwnedBySomeoneElse({\n            message:\n              \"An existing environment variable requires explicit adoption in a separate resource.\",\n            resourceType: EnvironmentVariables.Type,\n            physicalName: name,\n          });\n      }\n      const desired = Object.fromEntries(\n        Object.entries(news.variables).map(([name, value]) => [\n          name,\n          redacted(value),\n        ]),\n      );\n      const changes: Array<{\n        name: string;\n        value?: Redacted.Redacted<string>;\n      }> = [];\n      for (const [name, value] of Object.entries(desired)) {\n        const current = valueAt(observed, name);\n        if (\n          current === undefined ||\n          Redacted.value(current) !== Redacted.value(value)\n        )\n          changes.push({ name, value });\n      }\n      for (const name of previousNames) {\n        if (Object.hasOwn(desired, name)) continue;\n        const original = output ? valueAt(output.originals, name) : undefined;\n        const current = valueAt(observed, name);\n        if (original !== undefined) {\n          if (\n            current === undefined ||\n            Redacted.value(current) !== Redacted.value(original)\n          )\n            changes.push({ name, value: original });\n        } else if (current !== undefined) changes.push({ name });\n      }\n      if (changes.length > 0)\n        yield* client.updateEnvironmentVariables(\n          news.url,\n          news.deployKey,\n          changes,\n        );\n      return {\n        url: news.url,\n        deployKey: news.deployKey,\n        ownedNames,\n        variables: desired,\n        originals: select(output?.originals ?? {}, ownedNames),\n      };\n    }),\n    delete: Effect.fn(\"EnvironmentVariables.delete\")(function* ({ output }) {\n      const observed = yield* client\n        .listEnvironmentVariables(output.url, output.deployKey)\n        .pipe(Effect.catchTag(\"ConvexNotFound\", () => Effect.void));\n      if (observed === undefined) return;\n      const changes: Array<{\n        name: string;\n        value?: Redacted.Redacted<string>;\n      }> = [];\n      for (const name of output.ownedNames) {\n        const original = valueAt(output.originals, name);\n        const current = valueAt(observed, name);\n        if (original !== undefined) {\n          if (\n            current === undefined ||\n            Redacted.value(current) !== Redacted.value(original)\n          )\n            changes.push({ name, value: original });\n        } else if (current !== undefined) changes.push({ name });\n      }\n      if (changes.length > 0)\n        yield* client\n          .updateEnvironmentVariables(output.url, output.deployKey, changes)\n          .pipe(Effect.catchTag(\"ConvexNotFound\", () => Effect.void));\n    }),\n  } satisfies Provider.ProviderServiceInput<EnvironmentVariables>;\n});\n\n/**\n * Under `alchemy dev` variables are managed on the local backend. A backend\n * that is not running keeps its variables in its retained data, so removing\n * them is skipped rather than failing the apply.\n */\nexport const localProvider = Effect.map(\n  provider,\n  (service) =>\n    ({\n      ...service,\n      delete: (input) =>\n        // oxlint-disable-next-line effecttsgo/any-unknown-in-error-context -- Alchemy's provider input type erases the delete error channel.\n        service.delete(input).pipe(\n          Effect.catchIf(\n            (error) =>\n              error._tag === \"ConvexApiError\" &&\n              error.code === \"TransportError\",\n            () => Effect.void,\n          ),\n        ),\n    }) satisfies Provider.ProviderServiceInput<EnvironmentVariables>,\n);\n\nexport const layer = Provider.effect(EnvironmentVariables, provider);\nexport const localLayer = Provider.effect(\n  EnvironmentVariables,\n  localProvider,\n).pipe(\n  Layer.provide(\n    ConvexClient.layer({ mode: \"local\" }).pipe(\n      Layer.provide(FetchHttpClient.layer),\n    ),\n  ),\n);\n"],"mappings":"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"}