@alchemy.run/planetscale 0.0.0 → 2.0.0-beta.84

package/lib/Postgres/PostgresRole.js

@@ -0,0 +1,268 @@
+import * as planetscale from "@distilled.cloud/planetscale";
+import { Credentials } from "@distilled.cloud/planetscale/Credentials";
+import { deepEqual, isResolved } from "alchemy/Diff";
+import { createPhysicalName } from "alchemy/PhysicalName";
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import * as Effect from "effect/Effect";
+import * as Redacted from "effect/Redacted";
+import * as Stream from "effect/Stream";
+import { isKnownError, PlanetscaleConflict, waitForBranchReady } from "../Util.js";
+/** @resource */
+export const PostgresRole = Resource("Planetscale.PostgresRole");
+export const PostgresRoleProvider = () => Provider.succeed(PostgresRole, {
+    stables: ["id"],
+    diff: Effect.fn(function* ({ id, news, olds, output }) {
+        if (!isResolved(news))
+            return undefined;
+        // Successor is the only updatable property — everything else
+        // requires replacement.
+        if (news.ttl !== olds.ttl) {
+            return { action: "replace" };
+        }
+        const newDb = resolveDatabaseName(news.database);
+        const oldDb = olds.database ? resolveDatabaseName(olds.database) : undefined;
+        if (oldDb && newDb !== oldDb) {
+            return { action: "replace" };
+        }
+        const newBranch = resolveBranchName(news.branch);
+        const oldBranch = resolveBranchName(olds.branch);
+        if (newBranch !== oldBranch) {
+            return { action: "replace" };
+        }
+        const newRoles = [...resolveInheritedRoles(news.inheritedRoles)].sort();
+        const oldRoles = [...(output?.inheritedRoles ?? [])].sort();
+        if (!deepEqual(newRoles, oldRoles)) {
+            return { action: "replace" };
+        }
+        if ((news.withReplication ?? false) !== (output?.withReplication ?? false)) {
+            return { action: "replace" };
+        }
+        const oldName = output?.name ?? (yield* resolveName(id, olds?.name));
+        const newName = yield* resolveName(id, news.name);
+        if (newName !== oldName) {
+            return { action: "update" };
+        }
+        return undefined;
+    }),
+    read: Effect.fn(function* ({ output }) {
+        if (!output?.id)
+            return undefined;
+        return yield* planetscale
+            .getRole({
+            branch: output.branch,
+            database: output.database,
+            organization: output.organization,
+            id: output.id,
+        })
+            .pipe(Effect.map((token) => buildAttributes(token, output.password, {
+            inheritedRoles: token.inherited_roles,
+            successor: output.successor,
+            organization: output.organization,
+            database: output.database,
+            branch: token.branch.name,
+        })), Effect.catchTags({
+            Forbidden: () => Effect.succeed(undefined),
+            NotFound: () => Effect.succeed(undefined),
+        }));
+    }),
+    reconcile: Effect.fn(function* ({ id, news, output }) {
+        const { organization: envOrg } = yield* yield* Credentials;
+        const organization = resolveDatabaseOrg(news.database) ?? envOrg;
+        const databaseName = resolveDatabaseName(news.database);
+        const branchName = resolveBranchName(news.branch);
+        const inheritedRoles = resolveInheritedRoles(news.inheritedRoles);
+        const successor = resolveSuccessorName(news.successor);
+        const desiredName = yield* resolveName(id, news.name);
+        // 1. Observe — fetch live state if we know the role id. Roles
+        //    can only be looked up by id; without a cached id there is
+        //    no way to find the live role, so we fall through to ensure.
+        const observed = output?.id
+            ? yield* planetscale
+                .getRole({
+                id: output.id,
+                branch: branchName,
+                organization,
+                database: databaseName,
+            })
+                .pipe(Effect.catchTag("NotFound", () => Effect.succeed(undefined)))
+            : undefined;
+        // 2. Ensure — create if missing. Single branch covers both
+        //    greenfield (no output) and out-of-band-deletion (output
+        //    cached but cloud lost it). The latter is structurally a
+        //    rotation: the new role has fresh id/host/username/plaintext
+        //    that propagate downstream through the dependency graph.
+        //    There is no path to recover the original plaintext, so
+        //    recreating is the only way to converge.
+        //
+        //    Planetscale returns the plaintext password value exactly
+        //    once on create; on an observe-hit we re-use the cached
+        //    plaintext from output (which is why adoption requires
+        //    pre-existing state — see `read`).
+        let live;
+        let plaintext;
+        if (observed) {
+            live = observed;
+            plaintext = output.password;
+        }
+        else {
+            const branchInfo = yield* planetscale.getBranch({
+                organization,
+                database: databaseName,
+                branch: branchName,
+            });
+            if (branchInfo.kind !== "postgresql") {
+                return yield* new PlanetscaleConflict({
+                    message: `Cannot create a Role on MySQL database "${databaseName}". Roles are only supported on PostgreSQL. Use Password for MySQL.`,
+                });
+            }
+            if (!branchInfo.ready) {
+                yield* waitForBranchReady(organization, databaseName, branchName);
+            }
+            const created = yield* planetscale.createRole({
+                name: desiredName,
+                branch: branchName,
+                organization,
+                database: databaseName,
+                ttl: news.ttl,
+                inherited_roles: inheritedRoles,
+                with_replication: news.withReplication,
+            });
+            if (!created.password) {
+                return yield* Effect.die(`Planetscale did not return a password for Role "${desiredName}".`);
+            }
+            plaintext = created.password;
+            live = created;
+        }
+        // 3. Sync — only `name` is mutable in place; diff observed
+        //    against desired and skip the API call when nothing
+        //    changed. Everything else triggers a replace via diff().
+        if (live.name !== desiredName) {
+            live = yield* planetscale.updateRole({
+                id: live.id,
+                branch: branchName,
+                organization,
+                database: databaseName,
+                name: desiredName,
+            });
+        }
+        // 4. Return — fresh attrs sourced from observed cloud state,
+        //    with cached or freshly-issued plaintext.
+        return buildAttributes(live, plaintext, {
+            inheritedRoles: live.inherited_roles,
+            successor,
+            organization,
+            database: databaseName,
+            branch: branchName,
+        });
+    }),
+    delete: Effect.fn(function* ({ output }) {
+        yield* planetscale
+            .deleteRole({
+            organization: output.organization,
+            database: output.database,
+            branch: output.branch,
+            id: output.id,
+            successor: output.successor,
+        })
+            .pipe(Effect.catchTag("NotFound", () => Effect.void), 
+        // 422 (UnprocessableEntity): role is still referenced. Log a
+        // warning rather than failing — the role will be cleaned up
+        // when the database/branch is deleted.
+        Effect.catchIf(isKnownError("UnprocessableEntity", "Role is still referenced and cannot be dropped."), () => Effect.void));
+    }),
+    list: Effect.fn(function* () {
+        const { organization } = yield* yield* Credentials;
+        const databases = yield* planetscale.listDatabases.pages({ organization }).pipe(Stream.runCollect, Effect.map((chunk) => Array.from(chunk).flatMap((page) => page.data.filter((db) => db.kind === "postgresql"))));
+        const rows = yield* Effect.forEach(databases, (db) => planetscale.listBranches.pages({ organization, database: db.name }).pipe(Stream.runCollect, Effect.map((branchPages) => Array.from(branchPages).flatMap((page) => page.data.filter((branch) => branch.kind === "postgresql"))), Effect.catchTag("NotFound", () => Effect.succeed([{ name: db.default_branch ?? "main" }])), Effect.flatMap((branches) => Effect.forEach(branches, (branch) => planetscale.listRoles
+            .pages({
+            organization,
+            database: db.name,
+            branch: branch.name,
+        })
+            .pipe(Stream.runCollect, Effect.map((rolePages) => Array.from(rolePages).flatMap((page) => page.data
+            .filter((role) => !role.default)
+            .map((role) => buildAttributes(role, Redacted.make(""), {
+            inheritedRoles: role.inherited_roles,
+            successor: "postgres",
+            organization,
+            database: db.name,
+            branch: branch.name,
+        })))), Effect.catchTags({
+            NotFound: () => Effect.succeed([]),
+            Forbidden: () => Effect.succeed([]),
+        })), { concurrency: 10 }).pipe(Effect.map((perBranch) => perBranch.flat())))), { concurrency: 10 });
+        return rows.flat();
+    }),
+});
+const resolveDatabaseName = (database) => {
+    const ref = database;
+    return typeof ref === "string" ? ref : ref.name;
+};
+const resolveDatabaseOrg = (database) => {
+    const ref = database;
+    return typeof ref === "string" ? undefined : ref.organization;
+};
+const resolveBranchName = (branch) => {
+    const ref = branch;
+    return !ref ? "main" : typeof ref === "string" ? ref : ref.name;
+};
+const resolveSuccessorName = (successor) => {
+    const ref = successor;
+    return !ref ? "postgres" : typeof ref === "string" ? ref : ref.name;
+};
+const resolveInheritedRoles = (inheritedRoles) => {
+    if (Array.isArray(inheritedRoles)) {
+        return inheritedRoles;
+    }
+    // At runtime, a Role passed in is its resolved attributes (with
+    // `inheritedRoles` as a plain array); statically `Role.inheritedRoles`
+    // is `Output<InheritedRole[]>`.
+    return inheritedRoles
+        .inheritedRoles;
+};
+const resolveName = (id, name) => Effect.gen(function* () {
+    return name ?? (yield* createPhysicalName({ id, lowercase: true, maxLength: 63 }));
+});
+const buildAttributes = (role, password, context) => {
+    const passwordValue = Redacted.value(password);
+    const connectionUrl = `postgresql://${role.username}:${passwordValue}@${role.access_host_url}:5432/${role.database_name}?sslmode=verify-full`;
+    const connectionUrlPooled = `postgresql://${role.username}:${passwordValue}@${role.access_host_url}:6432/${role.database_name}?sslmode=verify-full`;
+    return {
+        id: role.id,
+        name: role.name,
+        expiresAt: role.expires_at,
+        host: role.access_host_url,
+        username: role.username,
+        password,
+        connectionUrl: Redacted.make(connectionUrl),
+        connectionUrlPooled: Redacted.make(connectionUrlPooled),
+        privateHost: role.private_access_host_url,
+        privateConnectionServiceName: role.private_connection_service_name,
+        inheritedRoles: context.inheritedRoles,
+        withReplication: role.with_replication,
+        successor: context.successor,
+        organization: context.organization,
+        database: context.database,
+        databaseName: role.database_name,
+        origin: {
+            scheme: "postgres",
+            host: role.access_host_url,
+            port: 5432,
+            database: role.database_name,
+            user: role.username,
+            password,
+        },
+        pooledOrigin: {
+            scheme: "postgres",
+            host: role.access_host_url,
+            port: 6432,
+            database: role.database_name,
+            user: role.username,
+            password,
+        },
+        branch: context.branch,
+        ttl: role.ttl,
+    };
+};
+//# sourceMappingURL=PostgresRole.js.map

package/lib/Postgres/PostgresRole.js.map

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

package/lib/Postgres/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./PostgresClusterSize.ts";
+export * from "./PostgresBranch.ts";
+export * from "./PostgresDatabase.ts";
+export * from "./PostgresDefaultRole.ts";
+export * from "./PostgresOrigin.ts";
+export * from "./PostgresRole.ts";
+//# sourceMappingURL=index.d.ts.map

package/lib/Postgres/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Postgres/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC"}

package/lib/Postgres/index.js

@@ -0,0 +1,7 @@
+export * from "./PostgresClusterSize.js";
+export * from "./PostgresBranch.js";
+export * from "./PostgresDatabase.js";
+export * from "./PostgresDefaultRole.js";
+export * from "./PostgresOrigin.js";
+export * from "./PostgresRole.js";
+//# sourceMappingURL=index.js.map

package/lib/Postgres/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Postgres/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC"}

package/lib/Providers.d.ts

@@ -0,0 +1,24 @@
+import * as Provider from "alchemy/Provider";
+import * as Layer from "effect/Layer";
+import * as Credentials from "./Credentials.ts";
+declare const Providers_base: Provider.ProviderCollection<Providers, "Planetscale">;
+/**
+ * Service tag bundling all PlanetScale providers + auth + credentials. Use
+ * `Planetscale.providers()` to materialize the full layer.
+ */
+export declare class Providers extends Providers_base {
+}
+export type ProviderRequirements = Layer.Services<ReturnType<typeof providers>>;
+/**
+ * Build the complete PlanetScale providers Layer. Provide this on a Stack
+ * (or via `Effect.provide` at test time) to enable all PlanetScale
+ * resources, the AuthProvider registration, and credential resolution.
+ *
+ * @example
+ * ```ts
+ * Effect.provide(Planetscale.providers())
+ * ```
+ */
+export declare const providers: () => Layer.Layer<Credentials.Credentials | import("alchemy/Auth/Credentials").CredentialsStore | import("effect/http/HttpClient").HttpClient | import("alchemy/Auth/Profile").ProfileStore | Providers, never, import("alchemy/Auth/AuthProvider").AuthProviders | import("effect/process/ChildProcessSpawner").ChildProcessSpawner | import("effect/Crypto").Crypto | import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("alchemy/Stack").Stack | import("alchemy/Stage").Stage>;
+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":"AAEA,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAE7C,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;;AAYhD;;;GAGG;AACH,qBAAa,SAAU,SAAQ,cAAuD;CAAG;AAEzF,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC;AAEhF;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,8eA8BnB,CAAC"}

package/lib/Providers.js

@@ -0,0 +1,40 @@
+import { CredentialsStoreLive } from "alchemy/Auth/Credentials";
+import { ProfileStoreLive } from "alchemy/Auth/Profile";
+import * as Provider from "alchemy/Provider";
+import * as FetchHttpClient from "effect/http/FetchHttpClient";
+import * as Layer from "effect/Layer";
+import { PlanetscaleAuth } from "./AuthProvider.js";
+import * as Credentials from "./Credentials.js";
+import { MySQLBranch, MySQLBranchProvider } from "./MySQL/MySQLBranch.js";
+import { MySQLDatabase, MySQLDatabaseProvider } from "./MySQL/MySQLDatabase.js";
+import { MySQLPassword, MySQLPasswordProvider } from "./MySQL/MySQLPassword.js";
+import { PostgresBranch, PostgresBranchProvider } from "./Postgres/PostgresBranch.js";
+import { PostgresDatabase, PostgresDatabaseProvider } from "./Postgres/PostgresDatabase.js";
+import { PostgresDefaultRole, PostgresDefaultRoleProvider, } from "./Postgres/PostgresDefaultRole.js";
+import { PostgresRole, PostgresRoleProvider } from "./Postgres/PostgresRole.js";
+/**
+ * Service tag bundling all PlanetScale providers + auth + credentials. Use
+ * `Planetscale.providers()` to materialize the full layer.
+ */
+export class Providers extends Provider.ProviderCollection()("Planetscale") {
+}
+/**
+ * Build the complete PlanetScale providers Layer. Provide this on a Stack
+ * (or via `Effect.provide` at test time) to enable all PlanetScale
+ * resources, the AuthProvider registration, and credential resolution.
+ *
+ * @example
+ * ```ts
+ * Effect.provide(Planetscale.providers())
+ * ```
+ */
+export const providers = () => Layer.effect(Providers, Provider.collection([
+    MySQLDatabase,
+    PostgresDatabase,
+    MySQLBranch,
+    PostgresBranch,
+    MySQLPassword,
+    PostgresRole,
+    PostgresDefaultRole,
+])).pipe(Layer.provide(Layer.mergeAll(MySQLDatabaseProvider(), PostgresDatabaseProvider(), MySQLBranchProvider(), PostgresBranchProvider(), MySQLPasswordProvider(), PostgresRoleProvider(), PostgresDefaultRoleProvider())), Layer.provideMerge(Credentials.fromAuthProvider()), Layer.provideMerge(FetchHttpClient.layer), Layer.provideMerge(PlanetscaleAuth), Layer.provideMerge(ProfileStoreLive), Layer.provideMerge(CredentialsStoreLive), 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,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,eAAe,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC5F,OAAO,EACL,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEhF;;;GAGG;AACH,MAAM,OAAO,SAAU,SAAQ,QAAQ,CAAC,kBAAkB,EAAa,CAAC,aAAa,CAAC;CAAG;AAIzF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,EAAE,CAC5B,KAAK,CAAC,MAAM,CACV,SAAS,EACT,QAAQ,CAAC,UAAU,CAAC;IAClB,aAAa;IACb,gBAAgB;IAChB,WAAW;IACX,cAAc;IACd,aAAa;IACb,YAAY;IACZ,mBAAmB;CACpB,CAAC,CACH,CAAC,IAAI,CACJ,KAAK,CAAC,OAAO,CACX,KAAK,CAAC,QAAQ,CACZ,qBAAqB,EAAE,EACvB,wBAAwB,EAAE,EAC1B,mBAAmB,EAAE,EACrB,sBAAsB,EAAE,EACxB,qBAAqB,EAAE,EACvB,oBAAoB,EAAE,EACtB,2BAA2B,EAAE,CAC9B,CACF,EACD,KAAK,CAAC,YAAY,CAAC,WAAW,CAAC,gBAAgB,EAAE,CAAC,EAClD,KAAK,CAAC,YAAY,CAAC,eAAe,CAAC,KAAK,CAAC,EACzC,KAAK,CAAC,YAAY,CAAC,eAAe,CAAC,EACnC,KAAK,CAAC,YAAY,CAAC,gBAAgB,CAAC,EACpC,KAAK,CAAC,YAAY,CAAC,oBAAoB,CAAC,EACxC,KAAK,CAAC,KAAK,CACZ,CAAC"}

package/lib/Util.d.ts

@@ -0,0 +1,93 @@
+import * as ps from "@distilled.cloud/planetscale";
+import type { ScopedPlanStatusSession } from "alchemy/Report";
+import * as Effect from "effect/Effect";
+import * as Schedule from "effect/Schedule";
+declare const NotReady_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "Planetscale::NotReady";
+} & Readonly<A>;
+/**
+ * Tagged error raised when polling for a state predicate that has not yet
+ * been reached. Used internally with `Effect.retry` to drive long-running
+ * status waits.
+ */
+export declare class NotReady extends NotReady_base<{
+    description: string;
+}> {
+}
+declare const PlanetscaleConflict_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "Planetscale::Conflict";
+} & Readonly<A>;
+/**
+ * Tagged error raised by reconcilers when an immutable property of a live
+ * PlanetScale resource does not match the desired configuration (e.g.
+ * region, kind, parent_branch). User-recoverable: change the config to
+ * match, or replace/delete the existing resource and retry.
+ */
+export declare class PlanetscaleConflict extends PlanetscaleConflict_base<{
+    message: string;
+}> {
+}
+declare const PlanetscaleDeletionProtected_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "Planetscale::DeletionProtected";
+} & Readonly<A>;
+/**
+ * Tagged error raised when deleting a database that has deletion
+ * protection enabled. Alchemy never turns protection off on its own:
+ * set `deletionProtection: false`, deploy, then delete.
+ */
+export declare class PlanetscaleDeletionProtected extends PlanetscaleDeletionProtected_base<{
+    message: string;
+    organization: string;
+    database: string;
+}> {
+}
+/**
+ * Deletes a database unless it has deletion protection enabled, in which
+ * case it fails with {@link PlanetscaleDeletionProtected}. A database that
+ * no longer exists counts as deleted.
+ */
+export declare const deleteUnprotectedDatabase: (organization: string, database: string) => Effect.Effect<undefined, ps.BadGateway | ps.BadRequest | ps.ConfigError | ps.Conflict | ps.Forbidden | ps.Services.planetscale.Forbidden | ps.GatewayTimeout | import("effect/http/HttpClientError").HttpClientError | ps.InternalServerError | ps.Locked | ps.PlanetScaleParseError | PlanetscaleDeletionProtected | ps.ServiceUnavailable | ps.TooManyRequests | ps.Unauthorized | ps.UnknownPlanetScaleError | ps.UnprocessableEntity | ps.Services.planetscale.UnprocessableEntity, ps.PlanetScaleOpContext>;
+/**
+ * Plans a database replacement. A replacement creates the new database
+ * before deleting the old one, so an explicit `name` that stays the same
+ * would make both generations the same database: reconcile would converge
+ * onto the old database and the cleanup of the old generation would then
+ * delete it. That plan fails with {@link PlanetscaleConflict} instead.
+ */
+export declare const replaceDatabase: (news: {
+    name?: string;
+}, output: {
+    name: string;
+} | undefined, change: string) => Effect.Effect<never, PlanetscaleConflict, never> | Effect.Effect<{
+    readonly action: "replace";
+}, never, never>;
+/**
+ * Generic polling helper that retries until `predicate(value)` returns true
+ * (or until the schedule is exhausted). Engine-specific helpers (e.g.
+ * `waitForKeyspaceReady`, `waitForPendingPostgresChanges`) are built on top
+ * of this primitive.
+ */
+export declare const pollUntil: <A, E, R>(description: string, fn: Effect.Effect<A, E, R>, predicate: (value: A) => boolean, schedule?: Schedule.Schedule<unknown, unknown, never>) => Effect.Effect<A, E, R>;
+/**
+ * Polls a branch via `getBranch` until it reports `ready === true`. Returns
+ * the final branch shape. `NotFound` during polling is treated as
+ * not-yet-ready (the branch is being provisioned by an upstream operation).
+ *
+ * If a `session` is supplied, each poll emits a note with elapsed seconds and
+ * expectation-setting so the CLI surfaces progress while we sit in the spaced
+ * retry loop.
+ */
+export declare const waitForBranchReady: (organization: string, database: string, branch: string, session?: ScopedPlanStatusSession | undefined) => Effect.Effect<ps.DatabaseBranch, ps.BadGateway | ps.BadRequest | ps.ConfigError | ps.Conflict | ps.Forbidden | ps.Services.planetscale.Forbidden | ps.GatewayTimeout | import("effect/http/HttpClientError").HttpClientError | ps.InternalServerError | ps.Locked | NotReady | ps.PlanetScaleParseError | ps.ServiceUnavailable | ps.TooManyRequests | ps.Unauthorized | ps.UnknownPlanetScaleError | ps.UnprocessableEntity | ps.Services.planetscale.UnprocessableEntity, ps.PlanetScaleOpContext>;
+/**
+ * Polls a database via `getDatabase` until it reports `ready === true`.
+ * `NotFound` during polling is treated as not-yet-ready (the database is
+ * being provisioned by an upstream operation).
+ *
+ * If a `session` is supplied, each poll emits a note with elapsed seconds and
+ * expectation-setting so the CLI surfaces progress while we sit in the spaced
+ * retry loop.
+ */
+export declare const waitForDatabaseReady: (organization: string, database: string, session?: ScopedPlanStatusSession | undefined) => Effect.Effect<ps.Database, ps.BadGateway | ps.BadRequest | ps.ConfigError | ps.Conflict | ps.Forbidden | ps.Services.planetscale.Forbidden | ps.GatewayTimeout | import("effect/http/HttpClientError").HttpClientError | ps.InternalServerError | ps.Locked | NotReady | ps.PlanetScaleParseError | ps.ServiceUnavailable | ps.TooManyRequests | ps.Unauthorized | ps.UnknownPlanetScaleError | ps.UnprocessableEntity | ps.Services.planetscale.UnprocessableEntity, ps.PlanetScaleOpContext>;
+export declare const isKnownError: (tag: string, message: string) => (error: unknown) => boolean;
+export {};
+//# sourceMappingURL=Util.d.ts.map

package/lib/Util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Util.d.ts","sourceRoot":"","sources":["../src/Util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,8BAA8B,CAAC;AACnD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAG9D,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;;;;AAE5C;;;;GAIG;AACH,qBAAa,QAAS,SAAQ,cAA0C;IACtE,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;CAAG;;;;AAEL;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,yBAA0C;IACjF,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;CAAG;;;;AAEL;;;;GAIG;AACH,qBAAa,4BAA6B,SAAQ,kCAEhD;IACA,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;CAAG;AAEL;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,8hBAuBpC,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,SACpB;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,UACf;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,UAC5B,MAAM;qBAYe,SAAS;gBAAY,CAAC;AAWrD;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,eAClB,MAAM,MACf,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,aACf,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,aACtB,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,KACnD,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAUK,CAAC;AAE9B;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,ilBAyB7B,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,2jBA4B/B,CAAC;AAEH,eAAO,MAAM,YAAY,QAAS,MAAM,WAAW,MAAM,aAAa,OAAO,YAId,CAAC"}

package/lib/Util.js

@@ -0,0 +1,135 @@
+import * as ps from "@distilled.cloud/planetscale";
+import * as Clock from "effect/Clock";
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+import * as Schedule from "effect/Schedule";
+/**
+ * Tagged error raised when polling for a state predicate that has not yet
+ * been reached. Used internally with `Effect.retry` to drive long-running
+ * status waits.
+ */
+export class NotReady extends Data.TaggedError("Planetscale::NotReady") {
+}
+/**
+ * Tagged error raised by reconcilers when an immutable property of a live
+ * PlanetScale resource does not match the desired configuration (e.g.
+ * region, kind, parent_branch). User-recoverable: change the config to
+ * match, or replace/delete the existing resource and retry.
+ */
+export class PlanetscaleConflict extends Data.TaggedError("Planetscale::Conflict") {
+}
+/**
+ * Tagged error raised when deleting a database that has deletion
+ * protection enabled. Alchemy never turns protection off on its own:
+ * set `deletionProtection: false`, deploy, then delete.
+ */
+export class PlanetscaleDeletionProtected extends Data.TaggedError("Planetscale::DeletionProtected") {
+}
+/**
+ * Deletes a database unless it has deletion protection enabled, in which
+ * case it fails with {@link PlanetscaleDeletionProtected}. A database that
+ * no longer exists counts as deleted.
+ */
+export const deleteUnprotectedDatabase = Effect.fn(function* (organization, database) {
+    const live = yield* ps
+        .getDatabase({ organization, database })
+        .pipe(Effect.catchTag("NotFound", () => Effect.succeed(undefined)));
+    if (!live)
+        return;
+    if (live.deletion_protected) {
+        return yield* new PlanetscaleDeletionProtected({
+            message: `Planetscale database "${database}" has deletion protection enabled. ` +
+                "Set `deletionProtection: false` and deploy before deleting it. " +
+                "If it is the old database of a replacement, the resource now " +
+                "manages the new database, so turn protection off on this one in " +
+                "PlanetScale directly, then deploy again.",
+            organization,
+            database,
+        });
+    }
+    yield* ps
+        .deleteDatabase({ organization, database })
+        .pipe(Effect.catchTag("NotFound", () => Effect.void));
+});
+/**
+ * Plans a database replacement. A replacement creates the new database
+ * before deleting the old one, so an explicit `name` that stays the same
+ * would make both generations the same database: reconcile would converge
+ * onto the old database and the cleanup of the old generation would then
+ * delete it. That plan fails with {@link PlanetscaleConflict} instead.
+ */
+export const replaceDatabase = (news, output, change) => news.name !== undefined && news.name === output?.name
+    ? Effect.fail(new PlanetscaleConflict({
+        message: `Changing the ${change} of Planetscale database "${news.name}" ` +
+            "requires a new database, but its explicit `name` is unchanged. " +
+            "Give the replacement a different `name`, or omit `name` to let " +
+            "Alchemy generate one.",
+    }))
+    : Effect.succeed({ action: "replace" });
+/**
+ * Default polling schedule: 5s spaced retries with a 30-minute total
+ * budget (360 × 5s). Avoids the exponential-blowup trap where later
+ * iterations would wait hours, indistinguishable from a hang. Postgres
+ * database creates routinely run 10-12 minutes, so a 10-minute budget
+ * regularly false-positives as "stuck".
+ */
+const defaultSchedule = Schedule.max([Schedule.spaced("5 seconds"), Schedule.recurs(360)]);
+/**
+ * Generic polling helper that retries until `predicate(value)` returns true
+ * (or until the schedule is exhausted). Engine-specific helpers (e.g.
+ * `waitForKeyspaceReady`, `waitForPendingPostgresChanges`) are built on top
+ * of this primitive.
+ */
+export const pollUntil = (description, fn, predicate, schedule = defaultSchedule) => 
+// oxlint-disable-next-line effecttsgo/unsafe-effect-type-assertion -- NotReady only escapes once the poll schedule is exhausted
+fn.pipe(Effect.flatMap((value) => predicate(value) ? Effect.succeed(value) : Effect.fail(new NotReady({ description }))), Effect.retry({
+    while: (e) => e?._tag === "Planetscale::NotReady",
+    schedule,
+}));
+/**
+ * Polls a branch via `getBranch` until it reports `ready === true`. Returns
+ * the final branch shape. `NotFound` during polling is treated as
+ * not-yet-ready (the branch is being provisioned by an upstream operation).
+ *
+ * If a `session` is supplied, each poll emits a note with elapsed seconds and
+ * expectation-setting so the CLI surfaces progress while we sit in the spaced
+ * retry loop.
+ */
+export const waitForBranchReady = Effect.fn(function* (organization, database, branch, session) {
+    const startedAt = yield* Clock.currentTimeMillis;
+    return yield* pollUntil(`branch "${branch}" ready`, Effect.gen(function* () {
+        if (session) {
+            const now = yield* Clock.currentTimeMillis;
+            const seconds = Math.floor((now - startedAt) / 1000);
+            yield* session.note(`Waiting for branch to be ready... (${seconds} seconds elapsed; this can take a few minutes)`);
+        }
+        return yield* ps.getBranch({ organization, database, branch });
+    }).pipe(Effect.catchTag("NotFound", () => Effect.fail(new NotReady({ description: `branch "${branch}" not found yet` })))), (data) => data.ready);
+});
+/**
+ * Polls a database via `getDatabase` until it reports `ready === true`.
+ * `NotFound` during polling is treated as not-yet-ready (the database is
+ * being provisioned by an upstream operation).
+ *
+ * If a `session` is supplied, each poll emits a note with elapsed seconds and
+ * expectation-setting so the CLI surfaces progress while we sit in the spaced
+ * retry loop.
+ */
+export const waitForDatabaseReady = Effect.fn(function* (organization, database, session) {
+    const startedAt = yield* Clock.currentTimeMillis;
+    return yield* pollUntil(`database "${database}" ready`, Effect.gen(function* () {
+        if (session) {
+            const now = yield* Clock.currentTimeMillis;
+            const seconds = Math.floor((now - startedAt) / 1000);
+            yield* session.note(`Waiting for database to be ready... (${seconds} seconds elapsed; this can take a few minutes)`);
+        }
+        return yield* ps.getDatabase({ organization, database });
+    }).pipe(Effect.catchTag("NotFound", () => Effect.fail(new NotReady({
+        description: `database "${database}" not found yet`,
+    })))), (data) => data.ready);
+});
+export const isKnownError = (tag, message) => (error) => typeof error === "object" &&
+    error !== null &&
+    error._tag === tag &&
+    error.message === message;
+//# sourceMappingURL=Util.js.map

package/lib/Util.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,9 @@
+export * as Auth from "./AuthProvider.ts";
+export { type BaseBranchAttributes, type BaseBranchProps, makeBranchProvider } from "./Branch.ts";
+export { Credentials, CredentialsFromEnv, DEFAULT_API_BASE_URL, fromAuthProvider, fromToken, } from "./Credentials.ts";
+export * from "./Database.ts";
+export * from "./MySQL/index.ts";
+export * from "./Postgres/index.ts";
+export * from "./Providers.ts";
+export * from "./Util.ts";
+//# sourceMappingURL=index.d.ts.map