@samebase/alchemy-convex 0.1.0

package/lib/PreviewDeployKey.d.ts

@@ -0,0 +1,34 @@
+import { Resource } from "alchemy";
+import * as Provider from "alchemy/Provider";
+import * as Redacted from "effect/Redacted";
+import * as Schema from "effect/Schema";
+import { ManagementApi } from "./ManagementApi.ts";
+import type { Providers } from "./Providers.ts";
+/** GET /projects/{project_id}/list_preview_deploy_keys */
+export declare const PreviewDeployKeyList: Schema.Struct<{
+    readonly items: Schema.$Array<Schema.Struct<{
+        readonly name: Schema.String;
+        readonly creationTime: Schema.Number;
+    }>>;
+}>;
+/** POST /projects/{project_id}/create_preview_deploy_key */
+export declare const CreatedPreviewDeployKey: Schema.Struct<{
+    readonly previewDeployKey: Schema.String;
+}>;
+export interface PreviewDeployKeyProps {
+    /** Numeric project id, such as `project.projectId`. */
+    readonly projectId: number;
+    /** Requested key name. Convex appends a short id to make it unique. */
+    readonly name: string;
+}
+export interface PreviewDeployKeyAttributes {
+    /** The name Convex lists the key under, such as "ci (6308e666)". */
+    readonly uniqueName: string;
+    readonly projectId: number;
+    /** The secret, such as `preview:<team>:<project>|<token>`. Convex returns it only at creation. */
+    readonly previewDeployKey: Redacted.Redacted<string>;
+}
+export type PreviewDeployKey = Resource<"Convex.PreviewDeployKey", PreviewDeployKeyProps, PreviewDeployKeyAttributes, never, Providers>;
+export declare const PreviewDeployKey: import("alchemy").ResourceClass<PreviewDeployKey>;
+export declare const PreviewDeployKeyProvider: () => import("effect/Layer").Layer<Provider.Provider<PreviewDeployKey>, never, ManagementApi>;
+//# sourceMappingURL=PreviewDeployKey.d.ts.map

package/lib/PreviewDeployKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PreviewDeployKey.d.ts","sourceRoot":"","sources":["../src/PreviewDeployKey.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAE7C,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAqB,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,0DAA0D;AAC1D,eAAO,MAAM,oBAAoB;;;;;EAAoD,CAAC;AAEtF,4DAA4D;AAC5D,eAAO,MAAM,uBAAuB;;EAAqD,CAAC;AAE1F,MAAM,WAAW,qBAAqB;IACpC,uDAAuD;IACvD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,0BAA0B;IACzC,oEAAoE;IACpE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,kGAAkG;IAClG,QAAQ,CAAC,gBAAgB,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;CACtD;AAED,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CACrC,yBAAyB,EACzB,qBAAqB,EACrB,0BAA0B,EAC1B,KAAK,EACL,SAAS,CACV,CAAC;AACF,eAAO,MAAM,gBAAgB,mDAAwD,CAAC;AAEtF,eAAO,MAAM,wBAAwB,+FA8ElC,CAAC"}

package/lib/PreviewDeployKey.js

@@ -0,0 +1,78 @@
+// Convex.PreviewDeployKey: a project key that creates and deploys preview
+// deployments, such as the key CI passes to `npx convex deploy` for a branch.
+//
+// Convex returns the secret only once, from create_preview_deploy_key. The
+// listing shows each key under a unique name, the requested name plus a short
+// id suffix, and delete_preview_deploy_key accepts that unique name. A key
+// cannot be changed after creation, so every property change is a replacement.
+import { Resource } from "alchemy";
+import { havePropsChanged, isResolved } from "alchemy/Diff";
+import * as Provider from "alchemy/Provider";
+import * as Effect from "effect/Effect";
+import * as Redacted from "effect/Redacted";
+import * as Schema from "effect/Schema";
+import { ListedKey, selectCreatedKey } from "./DeployKey.js";
+import { absentAsUndefined, ManagementApi } from "./ManagementApi.js";
+/** GET /projects/{project_id}/list_preview_deploy_keys */
+export const PreviewDeployKeyList = Schema.Struct({ items: Schema.Array(ListedKey) });
+/** POST /projects/{project_id}/create_preview_deploy_key */
+export const CreatedPreviewDeployKey = Schema.Struct({ previewDeployKey: Schema.String });
+export const PreviewDeployKey = Resource("Convex.PreviewDeployKey");
+export const PreviewDeployKeyProvider = () => Provider.effect(PreviewDeployKey, Effect.gen(function* () {
+    const api = yield* ManagementApi;
+    const listKeys = (projectId) => api
+        .request("list preview deploy keys", (client) => client.GET("/projects/{project_id}/list_preview_deploy_keys", {
+        params: { path: { project_id: projectId } },
+    }))
+        .pipe(Effect.map((body) => Schema.decodeUnknownSync(PreviewDeployKeyList)(body).items));
+    return {
+        stables: ["uniqueName", "projectId"],
+        diff: ({ olds, news, output }) => {
+            if (!isResolved(news))
+                return Effect.succeed(undefined);
+            // State written without the secret cannot hand a key to dependents,
+            // and Convex cannot return it again, so only a new key helps.
+            return Effect.succeed((output !== undefined && output.previewDeployKey === undefined) ||
+                havePropsChanged(olds, news)
+                ? { action: "replace" }
+                : { action: "noop" });
+        },
+        read: Effect.fn(function* ({ output }) {
+            // A key that is not in state has no known secret, so it is never adopted.
+            if (output === undefined)
+                return undefined;
+            const entries = yield* absentAsUndefined(listKeys(output.projectId));
+            return entries?.some((entry) => entry.name === output.uniqueName) ? output : undefined;
+        }),
+        reconcile: Effect.fn(function* ({ news, output }) {
+            if (output !== undefined) {
+                // The secret cannot be read back. A key that still exists keeps the one in state.
+                const entries = yield* listKeys(news.projectId);
+                if (entries.some((entry) => entry.name === output.uniqueName))
+                    return output;
+            }
+            const created = yield* api.request("create preview deploy key", (client) => client.POST("/projects/{project_id}/create_preview_deploy_key", {
+                params: { path: { project_id: news.projectId } },
+                body: { name: news.name },
+            }));
+            const { previewDeployKey } = Schema.decodeUnknownSync(CreatedPreviewDeployKey)(created);
+            const listed = selectCreatedKey(yield* listKeys(news.projectId), news.name);
+            if (listed === undefined) {
+                return yield* Effect.die(new Error(`Convex created preview deploy key "${news.name}" in project ${news.projectId} but does not list it`));
+            }
+            return {
+                uniqueName: listed.name,
+                projectId: news.projectId,
+                previewDeployKey: Redacted.make(previewDeployKey),
+            };
+        }),
+        delete: Effect.fn(function* ({ output }) {
+            // 404 PreviewDeployKeyNotFound: an earlier attempt or someone else deleted it.
+            yield* absentAsUndefined(api.requestVoid("delete preview deploy key", (client) => client.POST("/projects/{project_id}/delete_preview_deploy_key", {
+                params: { path: { project_id: output.projectId } },
+                body: { id: output.uniqueName },
+            })));
+        }),
+    };
+}));
+//# sourceMappingURL=PreviewDeployKey.js.map

package/lib/PreviewDeployKey.js.map

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

package/lib/Project.d.ts

@@ -0,0 +1,29 @@
+import { Resource } from "alchemy";
+import * as Provider from "alchemy/Provider";
+import type { components } from "@convex-dev/platform/managementApi";
+import { ManagementApi } from "./ManagementApi.ts";
+import type { Providers } from "./Providers.ts";
+/** Region names the Management API accepts, from the generated schema. */
+export type DeploymentRegion = components["schemas"]["RegionName"];
+export interface ProjectProps {
+    /** Team slug or numeric team id. A slug costs one extra lookup per run. */
+    readonly team: string | number;
+    /** Display name. Convex derives the slug from it. */
+    readonly name: string;
+    /** Region of the deployment created with the project. Defaults to the team default. */
+    readonly deploymentRegion?: DeploymentRegion;
+    /** Deployment created with the project. Defaults to `prod`. */
+    readonly deploymentType?: "prod" | "dev";
+}
+export interface ProjectAttributes {
+    readonly projectId: number;
+    readonly slug: string;
+    readonly name: string;
+    readonly teamId: number;
+    readonly prodDeploymentName: string | undefined;
+    readonly prodDeploymentUrl: string | undefined;
+}
+export type Project = Resource<"Convex.Project", ProjectProps, ProjectAttributes, never, Providers>;
+export declare const Project: import("alchemy").ResourceClass<Project>;
+export declare const ProjectProvider: () => import("effect/Layer").Layer<Provider.Provider<Project>, never, ManagementApi>;
+//# sourceMappingURL=Project.d.ts.map

package/lib/Project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Project.d.ts","sourceRoot":"","sources":["../src/Project.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGnC,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAG7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAqB,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,0EAA0E;AAC1E,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC;AAEnE,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uFAAuF;IACvF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAC7C,+DAA+D;IAC/D,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CAC1C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;CAChD;AAED,MAAM,MAAM,OAAO,GAAG,QAAQ,CAAC,gBAAgB,EAAE,YAAY,EAAE,iBAAiB,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;AACpG,eAAO,MAAM,OAAO,0CAAsC,CAAC;AA2B3D,eAAO,MAAM,eAAe,sFA6HzB,CAAC"}

package/lib/Project.js

@@ -0,0 +1,114 @@
+// Convex.Project: a project in a Convex team, with its default production deployment.
+//
+// The Management API has no project update endpoint, so every property change
+// is a replacement. Deleting a project deletes all of its deployments and data.
+import { Resource } from "alchemy";
+import { Unowned } from "alchemy/AdoptPolicy";
+import { isResolved } from "alchemy/Diff";
+import * as Provider from "alchemy/Provider";
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import { absentAsUndefined, ManagementApi } from "./ManagementApi.js";
+export const Project = Resource("Convex.Project");
+/** Fields of GET /projects/{id} and GET /teams/{team}/projects that the provider uses. */
+const ProjectDetails = Schema.Struct({
+    id: Schema.Number,
+    name: Schema.String,
+    slug: Schema.String,
+    teamId: Schema.Number,
+    prodDeploymentName: Schema.NullOr(Schema.String),
+});
+const ProjectList = Schema.Struct({ items: Schema.Array(ProjectDetails) });
+const CreatedProject = Schema.Struct({
+    projectId: Schema.Number,
+    slug: Schema.String,
+    deploymentName: Schema.NullOr(Schema.String),
+    deploymentUrl: Schema.NullOr(Schema.String),
+});
+const DeploymentRow = Schema.Struct({
+    name: Schema.String,
+    deploymentType: Schema.String,
+    isDefault: Schema.Boolean,
+    deploymentUrl: Schema.String,
+});
+const DeploymentRows = Schema.Array(DeploymentRow);
+export const ProjectProvider = () => Provider.effect(Project, Effect.gen(function* () {
+    const api = yield* ManagementApi;
+    const prodDeployment = (projectId) => api
+        .request("list deployments", (client) => client.GET("/projects/{project_id}/list_deployments", {
+        params: { path: { project_id: projectId } },
+    }))
+        .pipe(Effect.map((rows) => Schema.decodeUnknownSync(DeploymentRows)(rows).find((row) => row.deploymentType === "prod" && row.isDefault)));
+    const attributesOf = (details) => prodDeployment(details.id).pipe(Effect.map((prod) => ({
+        projectId: details.id,
+        slug: details.slug,
+        name: details.name,
+        teamId: details.teamId,
+        prodDeploymentName: prod?.name ?? details.prodDeploymentName ?? undefined,
+        prodDeploymentUrl: prod?.deploymentUrl,
+    })));
+    const getById = (projectId) => absentAsUndefined(api.request("get project", (client) => client.GET("/projects/{project_id}", { params: { path: { project_id: projectId } } }))).pipe(Effect.map((body) => body === undefined ? undefined : Schema.decodeUnknownSync(ProjectDetails)(body)));
+    const findByName = (team, name) => Effect.gen(function* () {
+        const teamId = yield* api.resolveTeamId(team);
+        const list = yield* api.request("list projects", (client) => client.GET("/teams/{team_id}/projects", { params: { path: { team_id: teamId } } }));
+        return Schema.decodeUnknownSync(ProjectList)(list).items.find((row) => row.name === name || row.slug === name);
+    });
+    return {
+        stables: ["projectId", "slug", "teamId"],
+        diff: ({ olds, news }) => {
+            if (!isResolved(news))
+                return Effect.succeed(undefined);
+            const changed = olds.team !== news.team ||
+                olds.name !== news.name ||
+                olds.deploymentRegion !== news.deploymentRegion ||
+                olds.deploymentType !== news.deploymentType;
+            return Effect.succeed(changed ? { action: "replace" } : { action: "noop" });
+        },
+        read: Effect.fn(function* ({ olds, output }) {
+            if (output !== undefined) {
+                const details = yield* getById(output.projectId);
+                return details === undefined ? undefined : yield* attributesOf(details);
+            }
+            // No state: an existing project with this name belongs to someone
+            // else until the user passes --adopt. Convex has no ownership tags.
+            const existing = yield* findByName(olds.team, olds.name);
+            return existing === undefined ? undefined : Unowned(yield* attributesOf(existing));
+        }),
+        reconcile: Effect.fn(function* ({ news, output }) {
+            if (output !== undefined) {
+                // Properties are all create-time; diff maps changes to replace.
+                const details = yield* getById(output.projectId);
+                if (details !== undefined)
+                    return yield* attributesOf(details);
+            }
+            // A crash after create and before state write is recovered by read;
+            // a project created by an earlier attempt is reused here too.
+            const existing = yield* findByName(news.team, news.name);
+            if (existing !== undefined)
+                return yield* attributesOf(existing);
+            const teamId = yield* api.resolveTeamId(news.team);
+            const created = yield* api.request("create project", (client) => client.POST("/teams/{team_id}/create_project", {
+                params: { path: { team_id: teamId } },
+                body: {
+                    projectName: news.name,
+                    deploymentType: news.deploymentType ?? "prod",
+                    ...(news.deploymentRegion === undefined
+                        ? {}
+                        : { deploymentRegion: news.deploymentRegion }),
+                },
+            }));
+            const parsed = Schema.decodeUnknownSync(CreatedProject)(created);
+            const details = yield* getById(parsed.projectId);
+            if (details === undefined) {
+                return yield* Effect.die(new Error(`Convex created project ${parsed.projectId} but it cannot be read back`));
+            }
+            return yield* attributesOf(details);
+        }),
+        delete: Effect.fn(function* ({ output }) {
+            yield* absentAsUndefined(api.requestVoid("delete project", (client) => client.POST("/projects/{project_id}/delete", {
+                params: { path: { project_id: output.projectId } },
+            })));
+        }),
+    };
+}));
+//# sourceMappingURL=Project.js.map

package/lib/Project.js.map

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

package/lib/Providers.d.ts

@@ -0,0 +1,13 @@
+import * as Provider from "alchemy/Provider";
+import * as Layer from "effect/Layer";
+import { type Credentials } from "./Credentials.ts";
+declare const Providers_base: Provider.ProviderCollection<Providers, "Convex">;
+export declare class Providers extends Providers_base {
+}
+/**
+ * All Convex resource providers. Pass a credentials layer to override the
+ * default lookup (`CONVEX_ACCESS_TOKEN`, then the Convex CLI login).
+ */
+export declare const providers: (credentials?: Layer.Layer<Credentials>) => Layer.Layer<Providers, never, import("effect/process/ChildProcessSpawner").ChildProcessSpawner | import("effect/FileSystem").FileSystem | import("effect/Path").Path>;
+export {};
+//# sourceMappingURL=Providers.d.ts.map

package/lib/Providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Providers.d.ts","sourceRoot":"","sources":["../src/Providers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,KAAK,WAAW,EAAc,MAAM,kBAAkB,CAAC;;AAYhE,qBAAa,SAAU,SAAQ,cAAkD;CAAG;AAEpF;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAI,cAAa,KAAK,CAAC,KAAK,CAAC,WAAW,CAAgB,0KA2B3E,CAAC"}

package/lib/Providers.js

@@ -0,0 +1,30 @@
+// The provider collection users merge into a stack:
+//   providers: Layer.mergeAll(Cloudflare.providers(), Convex.providers())
+import { CommandExecutorLive } from "alchemy/Command";
+import * as Provider from "alchemy/Provider";
+import * as Layer from "effect/Layer";
+import { fromConfig } from "./Credentials.js";
+import { DefaultEnvironmentVariable, DefaultEnvironmentVariableProvider, } from "./DefaultEnvironmentVariable.js";
+import { Deploy, DeployProvider } from "./Deploy.js";
+import { DeployKey, DeployKeyProvider } from "./DeployKey.js";
+import { EnvironmentVariable, EnvironmentVariableProvider } from "./EnvironmentVariable.js";
+import { ManagementApiLive } from "./ManagementApi.js";
+import { PreviewDeployKey, PreviewDeployKeyProvider } from "./PreviewDeployKey.js";
+import { Project, ProjectProvider } from "./Project.js";
+export class Providers extends Provider.ProviderCollection()("Convex") {
+}
+/**
+ * All Convex resource providers. Pass a credentials layer to override the
+ * default lookup (`CONVEX_ACCESS_TOKEN`, then the Convex CLI login).
+ */
+export const providers = (credentials = fromConfig()) => Layer.effect(Providers, Provider.collection([
+    Project,
+    DeployKey,
+    PreviewDeployKey,
+    EnvironmentVariable,
+    DefaultEnvironmentVariable,
+    Deploy,
+])).pipe(Layer.provide(Layer.mergeAll(ProjectProvider(), DeployKeyProvider(), PreviewDeployKeyProvider(), EnvironmentVariableProvider(), DefaultEnvironmentVariableProvider(), DeployProvider())), Layer.provide(ManagementApiLive()), Layer.provide(credentials), 
+// Convex.Deploy runs the Convex CLI through Alchemy's command executor.
+Layer.provide(CommandExecutorLive()), Layer.orDie);
+//# sourceMappingURL=Providers.js.map

package/lib/Providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Providers.js","sourceRoot":"","sources":["../src/Providers.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,0EAA0E;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,EAAoB,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EACL,0BAA0B,EAC1B,kCAAkC,GACnC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAExD,MAAM,OAAO,SAAU,SAAQ,QAAQ,CAAC,kBAAkB,EAAa,CAAC,QAAQ,CAAC;CAAG;AAEpF;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,cAAwC,UAAU,EAAE,EAAE,EAAE,CAChF,KAAK,CAAC,MAAM,CACV,SAAS,EACT,QAAQ,CAAC,UAAU,CAAC;IAClB,OAAO;IACP,SAAS;IACT,gBAAgB;IAChB,mBAAmB;IACnB,0BAA0B;IAC1B,MAAM;CACP,CAAC,CACH,CAAC,IAAI,CACJ,KAAK,CAAC,OAAO,CACX,KAAK,CAAC,QAAQ,CACZ,eAAe,EAAE,EACjB,iBAAiB,EAAE,EACnB,wBAAwB,EAAE,EAC1B,2BAA2B,EAAE,EAC7B,kCAAkC,EAAE,EACpC,cAAc,EAAE,CACjB,CACF,EACD,KAAK,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,EAClC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;AAC1B,wEAAwE;AACxE,KAAK,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC,EACpC,KAAK,CAAC,KAAK,CACZ,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,10 @@
+export { ACCESS_TOKEN_ENV, Credentials, CredentialsError, fromConfig, fromToken, } from "./Credentials.ts";
+export { DefaultEnvironmentVariable, type DefaultEnvironmentVariableAttributes, type DefaultEnvironmentVariableProps, type DeploymentType, } from "./DefaultEnvironmentVariable.ts";
+export { Deploy, type DeployAttributes, deployArgs, type DeployProps, parseDeployOutput, } from "./Deploy.ts";
+export { DeployKey, type DeployKeyAction, type DeployKeyAttributes, type DeployKeyProps, } from "./DeployKey.ts";
+export { EnvironmentVariable, type EnvironmentVariableAttributes, type EnvironmentVariableProps, } from "./EnvironmentVariable.ts";
+export { ConvexApiError, ManagementApi } from "./ManagementApi.ts";
+export { PreviewDeployKey, type PreviewDeployKeyAttributes, type PreviewDeployKeyProps, } from "./PreviewDeployKey.ts";
+export { type DeploymentRegion, Project, type ProjectAttributes, type ProjectProps, } from "./Project.ts";
+export { Providers, providers } from "./Providers.ts";
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,SAAS,GACV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,0BAA0B,EAC1B,KAAK,oCAAoC,EACzC,KAAK,+BAA+B,EACpC,KAAK,cAAc,GACpB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,MAAM,EACN,KAAK,gBAAgB,EACrB,UAAU,EACV,KAAK,WAAW,EAChB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,SAAS,EACT,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,GAC9B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EACL,gBAAgB,EAChB,KAAK,0BAA0B,EAC/B,KAAK,qBAAqB,GAC3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,KAAK,gBAAgB,EACrB,OAAO,EACP,KAAK,iBAAiB,EACtB,KAAK,YAAY,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/lib/index.js

@@ -0,0 +1,11 @@
+// @samebase/alchemy-convex: Convex resources for Alchemy v2.
+export { ACCESS_TOKEN_ENV, Credentials, CredentialsError, fromConfig, fromToken, } from "./Credentials.js";
+export { DefaultEnvironmentVariable, } from "./DefaultEnvironmentVariable.js";
+export { Deploy, deployArgs, parseDeployOutput, } from "./Deploy.js";
+export { DeployKey, } from "./DeployKey.js";
+export { EnvironmentVariable, } from "./EnvironmentVariable.js";
+export { ConvexApiError, ManagementApi } from "./ManagementApi.js";
+export { PreviewDeployKey, } from "./PreviewDeployKey.js";
+export { Project, } from "./Project.js";
+export { Providers, providers } from "./Providers.js";
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,SAAS,GACV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,0BAA0B,GAI3B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,MAAM,EAEN,UAAU,EAEV,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,SAAS,GAIV,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,mBAAmB,GAGpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EACL,gBAAgB,GAGjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,OAAO,GAGR,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@samebase/alchemy-convex",
+  "version": "0.1.0",
+  "description": "Convex resources for Alchemy v2: projects, deploy keys, environment variables, and a deploy step",
+  "keywords": [
+    "alchemy",
+    "cloudflare",
+    "convex",
+    "effect",
+    "infrastructure-as-code"
+  ],
+  "homepage": "https://github.com/samebase/alchemy-convex#readme",
+  "bugs": {
+    "url": "https://github.com/samebase/alchemy-convex/issues"
+  },
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/samebase/alchemy-convex.git"
+  },
+  "files": [
+    "lib",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "check": "vp fmt --check && vp lint && pnpm run typecheck && vp test --run",
+    "typecheck": "tsc --noEmit",
+    "test": "vp test --run",
+    "test:live": "ALCHEMY_CONVEX_LIVE=1 vp test --run test/live",
+    "format": "vp fmt",
+    "lint": "vp lint",
+    "build": "rm -rf lib && tsc -p tsconfig.build.json",
+    "prepack": "pnpm run build"
+  },
+  "dependencies": {
+    "@convex-dev/platform": "0.1.11"
+  },
+  "devDependencies": {
+    "@effect/platform-node": "4.0.0",
+    "@effect/vitest": "4.0.0",
+    "@types/node": "^24.0.0",
+    "alchemy": "2.0.0-beta.80",
+    "convex": "^1.45.0",
+    "effect": "4.0.0",
+    "typescript": "^5.9.0",
+    "vite-plus": "0.3.0",
+    "vitest": "^4.0.0"
+  },
+  "peerDependencies": {
+    "@effect/platform-node": "^4.0.0",
+    "alchemy": "2.0.0-beta.80",
+    "effect": "^4.0.0"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "packageManager": "pnpm@11.18.0"
+}

package/src/Credentials.ts

@@ -0,0 +1,78 @@
+// Convex control-plane credentials for the provider.
+//
+// The service value is an Effect so that building the providers layer never
+// touches the environment or the filesystem. The token is read on the first
+// lifecycle call, which keeps `alchemy plan` on an unrelated stack free of
+// Convex credential errors.
+import { readFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import * as Config from "effect/Config";
+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";
+
+export interface ResolvedCredentials {
+  /** Bearer token accepted by https://api.convex.dev/v1: a team access token, an OAuth token, or the Convex CLI login. */
+  readonly accessToken: Redacted.Redacted<string>;
+  /** Where the token came from, for error messages only. */
+  readonly source: "env" | "explicit" | "convex-cli-login";
+}
+
+export class Credentials extends Context.Service<Credentials, Effect.Effect<ResolvedCredentials>>()(
+  "@samebase/alchemy-convex/Credentials",
+) {}
+
+/** Environment variable read by {@link fromConfig}. */
+export const ACCESS_TOKEN_ENV = "CONVEX_ACCESS_TOKEN";
+
+/** The Convex CLI stores its device login here after `npx convex login`. */
+export const convexCliConfigPath = () => join(homedir(), ".convex", "config.json");
+
+const CliConfig = Schema.Struct({ accessToken: Schema.String });
+
+/**
+ * Token the Convex CLI saved on this machine. It works on the Management API
+ * for the teams the logged-in user belongs to. Fails when nobody is logged in.
+ */
+export const readConvexCliLogin: Effect.Effect<ResolvedCredentials, CredentialsError> = Effect.gen(
+  function* () {
+    const path = convexCliConfigPath();
+    const text = yield* Effect.tryPromise({
+      try: () => readFile(path, "utf8"),
+      catch: () => new CredentialsError({ reason: `no Convex CLI login at ${path}` }),
+    });
+    const parsed = yield* Schema.decodeUnknownEffect(Schema.fromJsonString(CliConfig))(text).pipe(
+      Effect.mapError(() => new CredentialsError({ reason: `${path} has no accessToken` })),
+    );
+    return { accessToken: Redacted.make(parsed.accessToken), source: "convex-cli-login" } as const;
+  },
+);
+
+export class CredentialsError extends Schema.TaggedError<CredentialsError>()("CredentialsError", {
+  reason: Schema.String,
+}) {}
+
+/**
+ * Default resolution: `CONVEX_ACCESS_TOKEN` from the stack ConfigProvider
+ * (process env, `.env`, stack secrets), then the Convex CLI login on this
+ * machine. CI sets the variable; a developer who ran `npx convex login` needs
+ * nothing.
+ */
+export const fromConfig = (): Layer.Layer<Credentials> =>
+  Layer.succeed(
+    Credentials,
+    Effect.cached(
+      Config.Redacted(ACCESS_TOKEN_ENV).pipe(
+        Effect.map((accessToken): ResolvedCredentials => ({ accessToken, source: "env" })),
+        Effect.catch(() => readConvexCliLogin),
+        Effect.orDie,
+      ),
+    ).pipe(Effect.flatten),
+  );
+
+/** Explicit token, for tests or callers that already hold a value. */
+export const fromToken = (accessToken: Redacted.Redacted<string>): Layer.Layer<Credentials> =>
+  Layer.succeed(Credentials, Effect.succeed({ accessToken, source: "explicit" } as const));