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

package/LICENSE

@@ -0,0 +1,7 @@
+ISC License
+
+Copyright 2024 RJ Dellecese
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -1,3 +1,23 @@
-# Temporary Holding Version
+# @confect/alchemy
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Alchemy resources for Convex cloud projects, deployments, deploy keys, environment variables, and code deployments. `Confect.Backend` runs Confect codegen before deploying an existing application.
+
+```ts
+import { Confect, Convex } from "@confect/alchemy";
+```
+
+Use `Convex.providers()` in your Alchemy stack. The integration targets Alchemy `2.0.0-beta.82` and Effect v4; it does not add Alchemy dependencies to Confect's runtime packages. Plain Convex applications can use `Convex.Code` without the Confect CLI.
+
+See the [deployment guide](https://confect.dev/guides/alchemy) for complete examples, credentials, ownership, and deletion policies.
+
+Projects and deployments are retained by default. Treat your Alchemy state as a secret store: it contains deployment credentials and managed environment values. Code deployment runs on every apply and never deletes data when removed from a stack. Pushes to one deployment from processes that share a user cache directory never overlap.
+
+Under `alchemy dev`, the same resources run against a local Convex backend that the integration downloads, starts, and stops with the dev session. Its data and credentials live in `.alchemy/convex/<stack>/<stage>/<deployment>`.
+
+## Tests
+
+Unit suites are per-module under `test/`. Cross-module lifecycle tests live under `test/integration/` and exercise Alchemy's engine with controlled API/process boundaries; they do not provision cloud resources. `test/integration/RealLocalBackend.test.ts` runs the pinned local backend: it downloads the release once into a cache under the OS temp directory, binds ports 3300-3399, and is skipped on Windows.
+
+```sh
+pnpm exec vitest run --project @confect/alchemy
+```

package/dist/Backend.d.ts

@@ -0,0 +1,45 @@
+import type * as Manifest from "@confect/core/Manifest";
+import type { Input } from "alchemy/Input";
+import * as Output from "alchemy/Output";
+import * as Effect from "effect/Effect";
+import type * as Redacted from "effect/Redacted";
+import { Code } from "./Code";
+import { EnvironmentVariables } from "./EnvironmentVariables";
+interface CommonProps {
+    readonly deployment: {
+        readonly name: Input<string>;
+        readonly url: Input<string>;
+    };
+    readonly deployKey: Input<Redacted.Redacted<string>>;
+    readonly cwd?: string;
+}
+type Environment<M extends Manifest.Manifest> = {
+    readonly [K in keyof Manifest.Values<M>]: Input<Exclude<Manifest.Values<M>[K], undefined>>;
+};
+export type BackendProps<M extends Manifest.Manifest | undefined = undefined> = CommonProps & (M extends Manifest.Manifest ? {
+    readonly manifest: M;
+} & ({} extends Manifest.Values<M> ? {
+    readonly env?: Environment<NoInfer<M>>;
+} : {
+    readonly env: Environment<NoInfer<M>>;
+}) : {
+    readonly manifest?: never;
+    readonly env?: Readonly<Record<string, Input<string | Redacted.Redacted<string>>>>;
+});
+/**
+ * Deploy a declared backend with env typed by its generated manifest.
+ */
+export declare function Backend<const M extends Manifest.Manifest, const E extends Environment<NoInfer<M>> = Environment<NoInfer<M>>>(id: string, props: BackendProps<M> & {
+    readonly env?: E & Readonly<Record<Exclude<keyof E, keyof M["env"]>, never>>;
+}): ReturnType<typeof backend>;
+export declare function Backend(id: string, props: BackendProps): ReturnType<typeof backend>;
+declare const backend: (id: string, props: CommonProps & {
+    readonly env?: Readonly<Record<string, Input<string | Redacted.Redacted<string>>>>;
+}) => Effect.Effect<{
+    code: Code;
+    environment: EnvironmentVariables | undefined;
+    name: Output.Output<string, never>;
+    url: Output.Output<string, never>;
+}, never, import("./Providers").Providers>;
+export {};
+//# sourceMappingURL=Backend.d.ts.map

package/dist/Backend.d.ts.map

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

package/dist/Backend.js

@@ -0,0 +1,38 @@
+import { Code } from "./Code.js";
+import { EnvironmentVariables } from "./EnvironmentVariables.js";
+import * as Namespace from "alchemy/Namespace";
+import * as Output from "alchemy/Output";
+import * as Effect from "effect/Effect";
+//#region src/Backend.ts
+function Backend(id, props) {
+	return backend(id, props);
+}
+const backend = (id, props) => Namespace.push(id, Effect.gen(function* () {
+	const environment = props.env === void 0 ? void 0 : yield* EnvironmentVariables("Environment", {
+		url: props.deployment.url,
+		deployKey: props.deployKey,
+		variables: props.env
+	});
+	const code = yield* Code("Code", {
+		deployment: {
+			name: props.deployment.name,
+			url: environment ? Output.map(Output.all(environment.variables, environment.url), ([, url]) => url) : props.deployment.url
+		},
+		deployKey: props.deployKey,
+		...props.cwd === void 0 ? {} : { cwd: props.cwd },
+		prepare: {
+			command: "confect",
+			args: ["codegen"]
+		}
+	});
+	return {
+		code,
+		environment,
+		name: code.name,
+		url: code.url
+	};
+}));
+//#endregion
+export { Backend };
+
+//# sourceMappingURL=Backend.js.map

package/dist/Backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Backend.js","names":[],"sources":["../src/Backend.ts"],"sourcesContent":["import type * as Manifest from \"@confect/core/Manifest\";\nimport type { Input } from \"alchemy/Input\";\nimport * as Namespace from \"alchemy/Namespace\";\nimport * as Output from \"alchemy/Output\";\nimport * as Effect from \"effect/Effect\";\nimport type * as Redacted from \"effect/Redacted\";\nimport { Code } from \"./Code\";\nimport { EnvironmentVariables } from \"./EnvironmentVariables\";\n\ninterface CommonProps {\n  readonly deployment: {\n    readonly name: Input<string>;\n    readonly url: Input<string>;\n  };\n  readonly deployKey: Input<Redacted.Redacted<string>>;\n  readonly cwd?: string;\n}\n\ntype Environment<M extends Manifest.Manifest> = {\n  readonly [K in keyof Manifest.Values<M>]: Input<\n    Exclude<Manifest.Values<M>[K], undefined>\n  >;\n};\n\nexport type BackendProps<M extends Manifest.Manifest | undefined = undefined> =\n  CommonProps &\n    (M extends Manifest.Manifest\n      ? { readonly manifest: M } & ({} extends Manifest.Values<M>\n          ? { readonly env?: Environment<NoInfer<M>> }\n          : { readonly env: Environment<NoInfer<M>> })\n      : {\n          readonly manifest?: never;\n          readonly env?: Readonly<\n            Record<string, Input<string | Redacted.Redacted<string>>>\n          >;\n        });\n\n/**\n * Deploy a declared backend with env typed by its generated manifest.\n */\nexport function Backend<\n  const M extends Manifest.Manifest,\n  const E extends Environment<NoInfer<M>> = Environment<NoInfer<M>>,\n>(\n  id: string,\n  props: BackendProps<M> & {\n    readonly env?: E &\n      Readonly<Record<Exclude<keyof E, keyof M[\"env\"]>, never>>;\n  },\n): ReturnType<typeof backend>;\nexport function Backend(\n  id: string,\n  props: BackendProps,\n): ReturnType<typeof backend>;\nexport function Backend(\n  id: string,\n  props: CommonProps & {\n    readonly env?: Readonly<\n      Record<string, Input<string | Redacted.Redacted<string>>>\n    >;\n  },\n): ReturnType<typeof backend> {\n  return backend(id, props);\n}\n\nconst backend = (\n  id: string,\n  props: CommonProps & {\n    readonly env?: Readonly<\n      Record<string, Input<string | Redacted.Redacted<string>>>\n    >;\n  },\n) =>\n  Namespace.push(\n    id,\n    Effect.gen(function* () {\n      const environment =\n        props.env === undefined\n          ? undefined\n          : yield* EnvironmentVariables(\"Environment\", {\n              url: props.deployment.url,\n              deployKey: props.deployKey,\n              variables: props.env,\n            });\n      const code = yield* Code(\"Code\", {\n        deployment: {\n          name: props.deployment.name,\n          url: environment\n            ? Output.map(\n                Output.all(environment.variables, environment.url),\n                ([, url]) => url,\n              )\n            : props.deployment.url,\n        },\n        deployKey: props.deployKey,\n        ...(props.cwd === undefined ? {} : { cwd: props.cwd }),\n        prepare: { command: \"confect\", args: [\"codegen\"] },\n      });\n      return { code, environment, name: code.name, url: code.url };\n    }),\n  );\n"],"mappings":";;;;;;AAsDA,SAAgB,QACd,IACA,OAK4B;CAC5B,OAAO,QAAQ,IAAI,KAAK;AAC1B;AAEA,MAAM,WACJ,IACA,UAMA,UAAU,KACR,IACA,OAAO,IAAI,aAAa;CACtB,MAAM,cACJ,MAAM,QAAQ,KAAA,IACV,KAAA,IACA,OAAO,qBAAqB,eAAe;EACzC,KAAK,MAAM,WAAW;EACtB,WAAW,MAAM;EACjB,WAAW,MAAM;CACnB,CAAC;CACP,MAAM,OAAO,OAAO,KAAK,QAAQ;EAC/B,YAAY;GACV,MAAM,MAAM,WAAW;GACvB,KAAK,cACD,OAAO,IACL,OAAO,IAAI,YAAY,WAAW,YAAY,GAAG,IAChD,GAAG,SAAS,GACf,IACA,MAAM,WAAW;EACvB;EACA,WAAW,MAAM;EACjB,GAAI,MAAM,QAAQ,KAAA,IAAY,CAAC,IAAI,EAAE,KAAK,MAAM,IAAI;EACpD,SAAS;GAAE,SAAS;GAAW,MAAM,CAAC,SAAS;EAAE;CACnD,CAAC;CACD,OAAO;EAAE;EAAM;EAAa,MAAM,KAAK;EAAM,KAAK,KAAK;CAAI;AAC7D,CAAC,CACH"}

package/dist/Code.d.ts

@@ -0,0 +1,80 @@
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import * as Effect from "effect/Effect";
+import type * as Redacted from "effect/Redacted";
+import type { Providers } from "./Providers";
+import { CommandRunner, type PrepareCommand } from "./internal/CommandRunner";
+import { PushLock } from "./internal/PushLock";
+export interface CodeProps {
+    readonly deployment: {
+        readonly name: string;
+        readonly url: string;
+    };
+    readonly deployKey: Redacted.Redacted<string>;
+    readonly cwd?: string;
+    readonly prepare?: PrepareCommand;
+}
+export interface CodeAttributes {
+    readonly name: string;
+    readonly url: string;
+}
+export type Code = Resource<"Convex.Code", CodeProps, CodeAttributes, never, Providers>;
+export declare const Code: import("alchemy/Resource").ResourceClass<Code>;
+export declare const provider: Effect.Effect<{
+    read: ({ output }: {
+        id: string;
+        fqn: string;
+        instanceId: string;
+        olds: CodeProps;
+        output: CodeAttributes | undefined;
+    }) => Effect.Effect<CodeAttributes | undefined, never, never>;
+    diff: () => Effect.Effect<{
+        action: "update";
+    }, never, never>;
+    reconcile: ({ news }: {
+        id: string;
+        fqn: string;
+        instanceId: string;
+        news: CodeProps;
+        olds: CodeProps | undefined;
+        output: CodeAttributes | undefined;
+        session: import("alchemy/Report").ScopedPlanStatusSession;
+        bindings: import("alchemy/Resource").ResourceBinding<never>[];
+    }) => Effect.Effect<{
+        name: string;
+        url: string;
+    }, import("./internal/CommandRunner").CommandError | import("./internal/CodeDeployment").InvalidDeploymentTarget | import("./internal/PushLock").PushLockError, never>;
+    delete: () => Effect.Effect<void, never, never>;
+}, never, CommandRunner | PushLock>;
+/**
+ * Under `alchemy dev`, pushes go to the local backend's self-hosted target.
+ */
+export declare const localProvider: Effect.Effect<{
+    read: ({ output }: {
+        id: string;
+        fqn: string;
+        instanceId: string;
+        olds: CodeProps;
+        output: CodeAttributes | undefined;
+    }) => Effect.Effect<CodeAttributes | undefined, never, never>;
+    diff: () => Effect.Effect<{
+        action: "update";
+    }, never, never>;
+    reconcile: ({ news }: {
+        id: string;
+        fqn: string;
+        instanceId: string;
+        news: CodeProps;
+        olds: CodeProps | undefined;
+        output: CodeAttributes | undefined;
+        session: import("alchemy/Report").ScopedPlanStatusSession;
+        bindings: import("alchemy/Resource").ResourceBinding<never>[];
+    }) => Effect.Effect<{
+        name: string;
+        url: string;
+    }, import("./internal/CommandRunner").CommandError | import("./internal/CodeDeployment").InvalidDeploymentTarget | import("./internal/PushLock").PushLockError, never>;
+    delete: () => Effect.Effect<void, never, never>;
+}, never, CommandRunner | PushLock>;
+export declare const layer: import("effect/Layer").Layer<Provider.Provider<Code>, never, CommandRunner | PushLock>;
+export declare const localLayer: import("effect/Layer").Layer<Provider.Provider<Code>, never, CommandRunner | PushLock>;
+//# sourceMappingURL=Code.d.ts.map

package/dist/Code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Code.d.ts","sourceRoot":"","sources":["../src/Code.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,UAAU,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,IAAI,GAAG,QAAQ,CACzB,aAAa,EACb,SAAS,EACT,cAAc,EACd,KAAK,EACL,SAAS,CACV,CAAC;AACF,eAAO,MAAM,IAAI,gDAAgC,CAAC;AAkBlD,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;mCAAe,CAAC;AACrC;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;mCAAgB,CAAC;AAE3C,eAAO,MAAM,KAAK,wFAAkC,CAAC;AACrD,eAAO,MAAM,UAAU,wFAAuC,CAAC"}

package/dist/Code.js

@@ -0,0 +1,29 @@
+import { CommandRunner } from "./internal/CommandRunner.js";
+import { PushLock } from "./internal/PushLock.js";
+import { deploy } from "./internal/CodeDeployment.js";
+import * as Effect from "effect/Effect";
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+//#region src/Code.ts
+const Code = Resource("Convex.Code");
+const make = (mode) => Effect.gen(function* () {
+	const runner = yield* CommandRunner;
+	const lock = yield* PushLock;
+	return {
+		read: ({ output }) => Effect.succeed(output),
+		diff: () => Effect.succeed({ action: "update" }),
+		reconcile: ({ news }) => deploy(news, mode).pipe(Effect.provideService(CommandRunner, runner), Effect.provideService(PushLock, lock)),
+		delete: () => Effect.void
+	};
+});
+const provider = make("live");
+/**
+* Under `alchemy dev`, pushes go to the local backend's self-hosted target.
+*/
+const localProvider = make("local");
+const layer = Provider.effect(Code, provider);
+const localLayer = Provider.effect(Code, localProvider);
+//#endregion
+export { Code, layer, localLayer, localProvider, provider };
+
+//# sourceMappingURL=Code.js.map

package/dist/Code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Code.js","names":[],"sources":["../src/Code.ts"],"sourcesContent":["import * as Provider from \"alchemy/Provider\";\nimport type { ProviderMode } from \"alchemy/ProviderMode\";\nimport { Resource } from \"alchemy/Resource\";\nimport * as Effect from \"effect/Effect\";\nimport type * as Redacted from \"effect/Redacted\";\nimport type { Providers } from \"./Providers\";\nimport { deploy } from \"./internal/CodeDeployment\";\nimport { CommandRunner, type PrepareCommand } from \"./internal/CommandRunner\";\nimport { PushLock } from \"./internal/PushLock\";\n\nexport interface CodeProps {\n  readonly deployment: { readonly name: string; readonly url: string };\n  readonly deployKey: Redacted.Redacted<string>;\n  readonly cwd?: string;\n  readonly prepare?: PrepareCommand;\n}\n\nexport interface CodeAttributes {\n  readonly name: string;\n  readonly url: string;\n}\n\nexport type Code = Resource<\n  \"Convex.Code\",\n  CodeProps,\n  CodeAttributes,\n  never,\n  Providers\n>;\nexport const Code = Resource<Code>(\"Convex.Code\");\n\nconst make = (mode: ProviderMode) =>\n  Effect.gen(function* () {\n    const runner = yield* CommandRunner;\n    const lock = yield* PushLock;\n    return {\n      read: ({ output }) => Effect.succeed(output),\n      diff: () => Effect.succeed({ action: \"update\" }),\n      reconcile: ({ news }) =>\n        deploy(news, mode).pipe(\n          Effect.provideService(CommandRunner, runner),\n          Effect.provideService(PushLock, lock),\n        ),\n      delete: () => Effect.void,\n    } satisfies Provider.ProviderServiceInput<Code>;\n  });\n\nexport const provider = make(\"live\");\n/**\n * Under `alchemy dev`, pushes go to the local backend's self-hosted target.\n */\nexport const localProvider = make(\"local\");\n\nexport const layer = Provider.effect(Code, provider);\nexport const localLayer = Provider.effect(Code, localProvider);\n"],"mappings":";;;;;;;AA6BA,MAAa,OAAO,SAAe,aAAa;AAEhD,MAAM,QAAQ,SACZ,OAAO,IAAI,aAAa;CACtB,MAAM,SAAS,OAAO;CACtB,MAAM,OAAO,OAAO;CACpB,OAAO;EACL,OAAO,EAAE,aAAa,OAAO,QAAQ,MAAM;EAC3C,YAAY,OAAO,QAAQ,EAAE,QAAQ,SAAS,CAAC;EAC/C,YAAY,EAAE,WACZ,OAAO,MAAM,IAAI,CAAC,CAAC,KACjB,OAAO,eAAe,eAAe,MAAM,GAC3C,OAAO,eAAe,UAAU,IAAI,CACtC;EACF,cAAc,OAAO;CACvB;AACF,CAAC;AAEH,MAAa,WAAW,KAAK,MAAM;;;;AAInC,MAAa,gBAAgB,KAAK,OAAO;AAEzC,MAAa,QAAQ,SAAS,OAAO,MAAM,QAAQ;AACnD,MAAa,aAAa,SAAS,OAAO,MAAM,aAAa"}

package/dist/Confect.d.ts

@@ -0,0 +1,2 @@
+export { Backend, type BackendProps } from "./Backend";
+//# sourceMappingURL=Confect.d.ts.map

package/dist/Confect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Confect.d.ts","sourceRoot":"","sources":["../src/Confect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC"}

package/dist/Confect.js

@@ -0,0 +1,8 @@
+import { __exportAll } from "./_virtual/_rolldown/runtime.js";
+import { Backend } from "./Backend.js";
+//#region src/Confect.ts
+var Confect_exports = /* @__PURE__ */ __exportAll({ Backend: () => Backend });
+//#endregion
+export { Backend, Confect_exports };
+
+//# sourceMappingURL=Confect.js.map

package/dist/Confect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Confect.js","names":[],"sources":["../src/Confect.ts"],"sourcesContent":["export { Backend, type BackendProps } from \"./Backend\";\n"],"mappings":""}

package/dist/Convex.d.ts

@@ -0,0 +1,7 @@
+export { Project, type ProjectProps, type ProjectAttributes } from "./Project";
+export { Deployment, type DeploymentProps, type DeploymentAttributes, } from "./Deployment";
+export { DeployKey, type DeployKeyProps, type DeployKeyAttributes, } from "./DeployKey";
+export { EnvironmentVariables, type EnvironmentVariablesProps, type EnvironmentVariablesAttributes, } from "./EnvironmentVariables";
+export { Code, type CodeProps, type CodeAttributes } from "./Code";
+export { providers, Providers } from "./Providers";
+//# sourceMappingURL=Convex.d.ts.map

package/dist/Convex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Convex.d.ts","sourceRoot":"","sources":["../src/Convex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC/E,OAAO,EACL,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,oBAAoB,GAC1B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,oBAAoB,EACpB,KAAK,yBAAyB,EAC9B,KAAK,8BAA8B,GACpC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,QAAQ,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/Convex.js

@@ -0,0 +1,21 @@
+import { __exportAll } from "./_virtual/_rolldown/runtime.js";
+import { Code } from "./Code.js";
+import { EnvironmentVariables } from "./EnvironmentVariables.js";
+import { Project } from "./Project.js";
+import { Deployment } from "./Deployment.js";
+import { DeployKey } from "./DeployKey.js";
+import { Providers, providers } from "./Providers.js";
+//#region src/Convex.ts
+var Convex_exports = /* @__PURE__ */ __exportAll({
+	Code: () => Code,
+	DeployKey: () => DeployKey,
+	Deployment: () => Deployment,
+	EnvironmentVariables: () => EnvironmentVariables,
+	Project: () => Project,
+	Providers: () => Providers,
+	providers: () => providers
+});
+//#endregion
+export { Code, Convex_exports, DeployKey, Deployment, EnvironmentVariables, Project, Providers, providers };
+
+//# sourceMappingURL=Convex.js.map

package/dist/Convex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Convex.js","names":[],"sources":["../src/Convex.ts"],"sourcesContent":["export { Project, type ProjectProps, type ProjectAttributes } from \"./Project\";\nexport {\n  Deployment,\n  type DeploymentProps,\n  type DeploymentAttributes,\n} from \"./Deployment\";\nexport {\n  DeployKey,\n  type DeployKeyProps,\n  type DeployKeyAttributes,\n} from \"./DeployKey\";\nexport {\n  EnvironmentVariables,\n  type EnvironmentVariablesProps,\n  type EnvironmentVariablesAttributes,\n} from \"./EnvironmentVariables\";\nexport { Code, type CodeProps, type CodeAttributes } from \"./Code\";\nexport { providers, Providers } from \"./Providers\";\n"],"mappings":""}

package/dist/ConvexClient.d.ts

@@ -0,0 +1,215 @@
+import type * as DeploymentApi from "@convex-dev/platform/deploymentApi";
+import type * as ManagementApi from "@convex-dev/platform/managementApi";
+import type { ProviderMode } from "alchemy/ProviderMode";
+import * as Context from "effect/Context";
+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 HttpClient from "effect/http/HttpClient";
+export type Project = ManagementApi.ProjectResponse;
+export type CreatedProject = ManagementApi.PlatformCreateProjectResponse;
+export type Deployment = ManagementApi.PlatformDeploymentResponse;
+export type DeployKey = Omit<ManagementApi.PlatformDeployKeyResponse, "allowedActions"> & {
+    readonly allowedActions: readonly string[];
+};
+export type CreateProjectInput = Pick<ManagementApi.PlatformCreateProjectArgs, "projectName">;
+export type UpdateProjectInput = Pick<ManagementApi.PlatformUpdateProjectArgs, "name">;
+export type CreateDeploymentInput = Pick<ManagementApi.PlatformCreateDeploymentArgs, "type" | "region" | "class"> & {
+    readonly reference: string;
+};
+export type UpdateDeploymentInput = Pick<ManagementApi.PlatformUpdateDeploymentArgs, "reference" | "expiresAt" | "sendLogsToClient">;
+export type CreateDeployKeyInput = ManagementApi.PlatformCreateDeployKeyArgs;
+export type CreatedDeployKey = {
+    readonly deployKey: Redacted.Redacted<ManagementApi.PlatformCreateDeployKeyResponse["deployKey"]>;
+};
+export type EnvironmentVariableChange = Omit<DeploymentApi.UpdateEnvVarRequest, "value"> & {
+    readonly value?: Exclude<DeploymentApi.UpdateEnvVarRequest["value"], undefined> | Redacted.Redacted<string>;
+};
+export type EnvironmentVariables = Readonly<Record<string, Redacted.Redacted<DeploymentApi.ListEnvVarsResponse["environmentVariables"][string]>>>;
+declare const ConvexApiError_base: Schema.Class<ConvexApiError, Schema.TaggedStruct<"ConvexApiError", {
+    operation: Schema.String;
+    status: Schema.optionalKey<Schema.Finite>;
+    code: Schema.Literals<readonly ["HttpError", "TransportError", "InvalidResponse", "InvalidRequest", "InvalidPagination", "InvalidConfiguration"]>;
+}>, import("effect/Cause").YieldableError>;
+export declare class ConvexApiError extends ConvexApiError_base {
+}
+declare const ConvexNotFound_base: Schema.Class<ConvexNotFound, Schema.TaggedStruct<"ConvexNotFound", {
+    operation: Schema.String;
+    status: Schema.optionalKey<Schema.Finite>;
+    code: Schema.Literals<readonly ["HttpError", "TransportError", "InvalidResponse", "InvalidRequest", "InvalidPagination", "InvalidConfiguration"]>;
+}>, import("effect/Cause").YieldableError>;
+export declare class ConvexNotFound extends ConvexNotFound_base {
+}
+declare const ConvexConflict_base: Schema.Class<ConvexConflict, Schema.TaggedStruct<"ConvexConflict", {
+    operation: Schema.String;
+    status: Schema.optionalKey<Schema.Finite>;
+    code: Schema.Literals<readonly ["HttpError", "TransportError", "InvalidResponse", "InvalidRequest", "InvalidPagination", "InvalidConfiguration"]>;
+}>, import("effect/Cause").YieldableError>;
+export declare class ConvexConflict extends ConvexConflict_base {
+}
+export type ConvexClientError = ConvexApiError | ConvexNotFound | ConvexConflict;
+declare const ConvexClient_base: Context.ServiceClass<ConvexClient, "@confect/alchemy/ConvexClient", {
+    listProjects: (teamId: number) => Effect.Effect<{
+        id: ManagementApi.components["schemas"]["ProjectId"];
+        name: ManagementApi.components["schemas"]["ProjectName"];
+        slug: ManagementApi.components["schemas"]["ProjectSlug"];
+        teamId: ManagementApi.components["schemas"]["TeamId"];
+        teamSlug: ManagementApi.components["schemas"]["TeamSlug"];
+        createTime: number;
+        prodDeploymentName?: string | null;
+        devDeploymentName?: string | null;
+    }[], ConvexApiError | ConvexConflict | ConvexNotFound, never>;
+    getProject: (projectId: number) => Effect.Effect<{
+        readonly id: number;
+        readonly name: string;
+        readonly slug: string;
+        readonly teamId: number;
+        readonly teamSlug: string;
+        readonly createTime: number;
+        readonly prodDeploymentName?: string | null;
+        readonly devDeploymentName?: string | null;
+    }, ConvexApiError | ConvexConflict | ConvexNotFound, never>;
+    createProject: (teamId: number, input: CreateProjectInput) => Effect.Effect<{
+        readonly id: number;
+        readonly projectId: number;
+        readonly slug: string;
+        readonly deploymentName?: string | null;
+        readonly deploymentUrl?: string | null;
+    }, ConvexApiError | ConvexConflict | ConvexNotFound, never>;
+    updateProject: (projectId: number, input: UpdateProjectInput) => Effect.Effect<{
+        readonly id: number;
+        readonly name: string;
+        readonly slug: string;
+        readonly teamId: number;
+        readonly teamSlug: string;
+        readonly createTime: number;
+        readonly prodDeploymentName?: string | null;
+        readonly devDeploymentName?: string | null;
+    }, ConvexApiError | ConvexConflict | ConvexNotFound, never>;
+    deleteProject: (projectId: number) => Effect.Effect<void, ConvexApiError | ConvexConflict | ConvexNotFound, never>;
+    listDeployments: (projectId: number) => Effect.Effect<readonly ({
+        readonly name: string;
+        readonly createTime: number;
+        readonly deploymentType: "custom" | "dev" | "preview" | "prod";
+        readonly projectId: number;
+        readonly previewIdentifier?: string | null;
+        readonly kind: "cloud";
+        readonly id: number;
+        readonly lastDeployTime?: number | null;
+        readonly creator?: number | null;
+        readonly region: "aws-ap-southeast-2" | "aws-ca-central-1" | "aws-eu-west-1" | "aws-us-east-1";
+        readonly isDefault: boolean;
+        readonly reference: string;
+        readonly dashboardEditConfirmation?: boolean | null;
+        readonly deploymentUrl: string;
+        readonly expiresAt?: number | null;
+        readonly class: string;
+        readonly sendLogsToClient?: boolean | null;
+    } | {
+        readonly name: string;
+        readonly createTime: number;
+        readonly deploymentType: "custom" | "dev" | "preview" | "prod";
+        readonly projectId: number;
+        readonly previewIdentifier?: string | null;
+        readonly kind: "local";
+        readonly creator: number;
+        readonly port: number;
+        readonly deviceName: string;
+        readonly isActive: boolean;
+    })[], ConvexApiError | ConvexConflict | ConvexNotFound, never>;
+    getDeployment: (name: string) => Effect.Effect<{
+        readonly name: string;
+        readonly createTime: number;
+        readonly deploymentType: "custom" | "dev" | "preview" | "prod";
+        readonly projectId: number;
+        readonly previewIdentifier?: string | null;
+        readonly kind: "cloud";
+        readonly id: number;
+        readonly lastDeployTime?: number | null;
+        readonly creator?: number | null;
+        readonly region: "aws-ap-southeast-2" | "aws-ca-central-1" | "aws-eu-west-1" | "aws-us-east-1";
+        readonly isDefault: boolean;
+        readonly reference: string;
+        readonly dashboardEditConfirmation?: boolean | null;
+        readonly deploymentUrl: string;
+        readonly expiresAt?: number | null;
+        readonly class: string;
+        readonly sendLogsToClient?: boolean | null;
+    } | {
+        readonly name: string;
+        readonly createTime: number;
+        readonly deploymentType: "custom" | "dev" | "preview" | "prod";
+        readonly projectId: number;
+        readonly previewIdentifier?: string | null;
+        readonly kind: "local";
+        readonly creator: number;
+        readonly port: number;
+        readonly deviceName: string;
+        readonly isActive: boolean;
+    }, ConvexApiError | ConvexConflict | ConvexNotFound, never>;
+    createDeployment: (projectId: number, input: CreateDeploymentInput) => Effect.Effect<{
+        readonly name: string;
+        readonly createTime: number;
+        readonly deploymentType: "custom" | "dev" | "preview" | "prod";
+        readonly projectId: number;
+        readonly previewIdentifier?: string | null;
+        readonly kind: "cloud";
+        readonly id: number;
+        readonly lastDeployTime?: number | null;
+        readonly creator?: number | null;
+        readonly region: "aws-ap-southeast-2" | "aws-ca-central-1" | "aws-eu-west-1" | "aws-us-east-1";
+        readonly isDefault: boolean;
+        readonly reference: string;
+        readonly dashboardEditConfirmation?: boolean | null;
+        readonly deploymentUrl: string;
+        readonly expiresAt?: number | null;
+        readonly class: string;
+        readonly sendLogsToClient?: boolean | null;
+    } | {
+        readonly name: string;
+        readonly createTime: number;
+        readonly deploymentType: "custom" | "dev" | "preview" | "prod";
+        readonly projectId: number;
+        readonly previewIdentifier?: string | null;
+        readonly kind: "local";
+        readonly creator: number;
+        readonly port: number;
+        readonly deviceName: string;
+        readonly isActive: boolean;
+    }, ConvexApiError | ConvexConflict | ConvexNotFound, never>;
+    updateDeployment: (name: string, input: UpdateDeploymentInput) => Effect.Effect<void, ConvexApiError | ConvexConflict | ConvexNotFound, never>;
+    deleteDeployment: (name: string) => Effect.Effect<void, ConvexApiError | ConvexConflict | ConvexNotFound, never>;
+    createDeployKey: (name: string, input: {
+        name: string;
+        allowedActions?: ("deployment:deploy" | "deployment:env:view" | "deployment:env:write" | "deployment:pause" | "deployment:unpause" | "deployment:logs:view" | "deployment:metrics:view" | "deployment:integrations:view" | "deployment:integrations:write" | "deployment:data:view" | "deployment:data:write" | "deployment:backups:view" | "deployment:backups:create" | "deployment:backups:download" | "deployment:backups:delete" | "deployment:backups:import" | "deployment:functions:actAsUser" | "deployment:functions:runInternalQueries" | "deployment:functions:runInternalMutations" | "deployment:functions:runInternalActions" | "deployment:functions:runTestQuery" | "deployment:auditLog:view" | "deployment:usageLimits:view" | "deployment:usageLimits:write" | "deployment:usage:view" | "deployment:aiGateway:use")[];
+        expiresAt?: number | null;
+    }) => Effect.Effect<CreatedDeployKey, ConvexClientError, never>;
+    listDeployKeys: (name: string) => Effect.Effect<readonly {
+        readonly id: number;
+        readonly name: string;
+        readonly creationTime: number;
+        readonly lastUsedTime?: number | null;
+        readonly expiresAt?: number | null;
+        readonly creator?: number | null;
+        readonly managedBy?: "vercel" | {
+            readonly oauthApp: string;
+        } | null;
+        readonly allowedActions: readonly string[];
+    }[], ConvexApiError | ConvexConflict | ConvexNotFound, never>;
+    deleteDeployKey: (name: string, id: string | Redacted.Redacted<string>) => Effect.Effect<void, ConvexApiError | ConvexConflict | ConvexNotFound, never>;
+    listEnvironmentVariables: (url: string, key: Redacted.Redacted<string>) => Effect.Effect<Readonly<Record<string, Redacted.Redacted<string>>>, ConvexClientError, never>;
+    updateEnvironmentVariables: (url: string, key: Redacted.Redacted<string>, changes: readonly EnvironmentVariableChange[]) => Effect.Effect<void, ConvexApiError | ConvexConflict | ConvexNotFound, never>;
+}>;
+export declare class ConvexClient extends ConvexClient_base {
+}
+/**
+ * `mode: "local"` sends deployment requests only to a loopback backend over
+ * HTTP; the default accepts only Convex cloud HTTPS origins.
+ */
+export declare const layer: (options?: {
+    readonly token?: Redacted.Redacted<string>;
+    readonly mode?: ProviderMode;
+}) => Layer.Layer<ConvexClient, never, HttpClient.HttpClient>;
+export {};
+//# sourceMappingURL=ConvexClient.d.ts.map

package/dist/ConvexClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConvexClient.d.ts","sourceRoot":"","sources":["../src/ConvexClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,aAAa,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,KAAK,aAAa,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,UAAU,MAAM,wBAAwB,CAAC;AAKrD,MAAM,MAAM,OAAO,GAAG,aAAa,CAAC,eAAe,CAAC;AACpD,MAAM,MAAM,cAAc,GAAG,aAAa,CAAC,6BAA6B,CAAC;AACzE,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC,0BAA0B,CAAC;AAClE,MAAM,MAAM,SAAS,GAAG,IAAI,CAC1B,aAAa,CAAC,yBAAyB,EACvC,gBAAgB,CACjB,GAAG;IACF,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C,CAAC;AACF,MAAM,MAAM,kBAAkB,GAAG,IAAI,CACnC,aAAa,CAAC,yBAAyB,EACvC,aAAa,CACd,CAAC;AACF,MAAM,MAAM,kBAAkB,GAAG,IAAI,CACnC,aAAa,CAAC,yBAAyB,EACvC,MAAM,CACP,CAAC;AACF,MAAM,MAAM,qBAAqB,GAAG,IAAI,CACtC,aAAa,CAAC,4BAA4B,EAC1C,MAAM,GAAG,QAAQ,GAAG,OAAO,CAC5B,GAAG;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AACnC,MAAM,MAAM,qBAAqB,GAAG,IAAI,CACtC,aAAa,CAAC,4BAA4B,EAC1C,WAAW,GAAG,WAAW,GAAG,kBAAkB,CAC/C,CAAC;AACF,MAAM,MAAM,oBAAoB,GAAG,aAAa,CAAC,2BAA2B,CAAC;AAC7E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,QAAQ,CACnC,aAAa,CAAC,+BAA+B,CAAC,WAAW,CAAC,CAC3D,CAAC;CACH,CAAC;AACF,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAC1C,aAAa,CAAC,mBAAmB,EACjC,OAAO,CACR,GAAG;IACF,QAAQ,CAAC,KAAK,CAAC,EACX,OAAO,CAAC,aAAa,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,GAC9D,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;CAC/B,CAAC;AACF,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CACzC,MAAM,CACJ,MAAM,EACN,QAAQ,CAAC,QAAQ,CACf,aAAa,CAAC,mBAAmB,CAAC,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAClE,CACF,CACF,CAAC;;;;;;AAeF,qBAAa,cAAe,SAAQ,mBAGnC;CAAG;;;;;;AAEJ,qBAAa,cAAe,SAAQ,mBAGnC;CAAG;;;;;;AAEJ,qBAAa,cAAe,SAAQ,mBAGnC;CAAG;AAEJ,MAAM,MAAM,iBAAiB,GACzB,cAAc,GACd,cAAc,GACd,cAAc,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAobnB,qBAAa,YAAa,SAAQ,iBAGE;CAAG;AAEvC;;;GAGG;AACH,eAAO,MAAM,KAAK,aAAc;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;CAC9B,4DAC4E,CAAC"}